Webhooks deliver the same event shape as the live SDK feed to your backend — so events survive your agent process being offline. Register an endpoint in the dashboard or via the management API. You receive a signing secret (whsec_…) once at creation.

Quickstart

Verify a signature and receive your first event in five minutes.

Events

Wire format — headers, body, and every event type.

When to use webhooks vs. the live feed

ApproachBest for
app.messages streamLong-running agents, lowest latency, full SDK surface
WebhooksServerless handlers, multi-worker fan-out, WhatsApp Business inbound
You can use both — they share the same event vocabulary.