360Dialog Webhooks

generated: '2026-11-01'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.360dialog.com/docs/mba/webhooks.md
sources:
- https://docs.360dialog.com/docs/mba/webhooks.md
- https://docs.360dialog.com/docs/hub/webhook-url.md
- https://docs.360dialog.com/docs/messaging/webhook.md
- https://docs.360dialog.com/docs/messaging/webhook/webhook-reference.md
description: 360dialog forwards Meta Business Agent (MBA) and standard WhatsApp Business Platform webhooks to the same endpoint you already use.
  Events are delivered as JSON payloads and are signed.
events:
- event: messages
  description: Consumer inbound messages that arrive while you hold the conversation (MBA) or standard inbound message notifications.
- event: standby
  description: Agent‑generated conversation data, including consumer inbound messages (`standby.messages[]`) and agent replies (`standby.message_echoes[]`).
- event: messaging_handovers
  description: Fires whenever control of a conversation changes between the Meta Business Agent and your side.
- event: statuses
  description: Message status notifications such as `sent`, `delivered`, `read`, `failed`, `played`.
- event: errors
  description: Operational or delivery error notifications.
delivery:
  signature: x-360dialog-signature
  content_type: application/json
note: Validate the signature with the same webhook secret you use for normal 360dialog callbacks; no additional secret is required.
docs: https://docs.360dialog.com/docs/mba/webhooks.md