Whatsapi Sh Webhooks

generated: '2026-10-31'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.whatsapi.sh/en/guides/webhooks
sources:
- https://docs.whatsapi.sh/en/guides/webhooks
- https://docs.whatsapi.sh/guides/webhooks
- https://docs.whatsapi.sh/es/guides/webhooks
description: Whatsapi‑sh provides a single webhook endpoint per account that can receive events for any of the numbers on the account.
events:
- event: message.created
  description: Fires when a new inbound or outbound message is created.
- event: message.sent
  description: Fires when a message that was waiting in the send queue is successfully sent.
- event: message.failed
  description: Fires when a message that was waiting in the send queue fails to send.
- event: message.status
  description: Fires when the delivery status of a message changes.
- event: number.connected
  description: Fires when a WhatsApp number becomes connected.
- event: number.disconnected
  description: Fires when a WhatsApp number becomes disconnected.
- event: number.logged_out
  description: Fires when a WhatsApp number logs out.
- event: number.history_synced
  description: Fires once per pairing after the phone has synced its old chats or has been idle for 10 minutes.
delivery:
  signature: 'Each delivery carries `x-whatsapi-signature: t=<unix>,v1=<hmac>` – an HMAC‑SHA256 of `<t>.<body>` using the secret shown when the
    webhook is created.'
  retries: Each event gets up to 5 delivery attempts. Retries occur on no response, 5xx, 408, 425 or 429 status codes, waiting 30, 60, 120 and
    240 seconds between attempts. A longer `Retry-After` header extends the wait, up to 1 hour per retry. Other 4xx responses and redirects stop
    retries. After 10 consecutive failed deliveries the endpoint is disabled.
docs: https://docs.whatsapi.sh/en/guides/webhooks