Aidelly Ai Webhooks

generated: '2026-11-01'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://www.aidelly.ai/docs/api/webhooks.md
sources:
- https://www.aidelly.ai/docs/api/webhooks.md
- https://www.aidelly.ai/docs/api/webhooks-reliability.md
- https://www.aidelly.ai/docs/api/webhooks
- https://www.aidelly.ai/docs/api/webhooks-reliability
description: Aidelly AI webhooks push real‑time notifications for post lifecycle events.
events:
- event: post.created
  description: A post is created (draft or scheduled).
- event: post.scheduled
  description: A post is confirmed scheduled.
- event: post.published
  description: A post is successfully published to the platform.
- event: post.failed
  description: A post failed to publish.
- event: post.canceled
  description: A post is canceled before publishing.
- event: inbox.item.created
  description: A new inbox message or comment is stored.
- event: inbox.lead.captured
  description: The AI DM agent first collects an email or phone number (once per conversation).
delivery:
  signature: HMAC‑SHA256 over the string `${timestamp}.${rawBody}` using the webhook's secret; provided in header `x-aidelly-signature` as `sha256=<hex>`.
  retries: 'Any non‑2xx response, timeout >15 s, or connection error triggers retries. Inline attempts: up to 3 tries spaced ~150 ms then 300 ms.
    If all fail, scheduled redelivery occurs at +15 min, +1 h, +3 h, +6 h, +12 h (five retries), each scheduled attempt again makes up to 3 quick
    inline tries. After the schedule is exhausted the delivery is marked `dead_letter` and not retried.'
note: Each delivery includes headers `x-aidelly-event`, `x-aidelly-event-id`, `x-aidelly-timestamp`, and `x-aidelly-signature`. The `x-aidelly-event-id`
  is stable across retries for deduplication.
docs: https://www.aidelly.ai/docs/api/webhooks.md