Skip to main content

Webhooks

Inbound provider webhooks and outbound platform events.

Meta and Telegram send inbound events to Engage webhook routes (no API key). Platform services emit Kafka events consumed by Insights and Billing.

Provider webhooks

  • /v1/engage/webhooks/meta: WhatsApp message and template status
  • /v1/engage/webhooks/telegram: Telegram bot updates
  • /v1/engage/webchat/*: web chat widget (public)
  • /v1/voice/webhooks/{provider}/{tenantId}/inbound|gather|status: voice IVR

Signature verification

Meta webhooks are verified with X-Hub-Signature-256 using your app secret. Always validate before processing payloads.