AI agents with WhatsApp webhooks
Receive WhatsApp webhooks on Trigger.dev and use them to start, resume or message your AI agents.
What you can do with WhatsApp webhooks
Start an agent
WhatsApp events can start a new agent run. For example, an agent that replies to every WhatsApp message.
Resume an agent
An agent can pause until the WhatsApp event it needs arrives, for up to 90 days, and costs nothing while it waits.
Message an agent
WhatsApp events can land in a running agent's conversation, so it acts on them with full context.
WhatsApp events
Every webhook WhatsApp sends reaches your endpoint. See WhatsApp's docs for what it can send.
Example
An agent that replies to every WhatsApp message
Handled for you
Verified for you
webhooks.whatsapp() checks the X-Hub-Signature-256 header on every request. Bad requests are rejected before anything runs.
Filter before anything runs
Only the WhatsApp events you care about start a run. Filtered webhooks use no compute.
See every delivery
Every webhook is recorded with its payload, headers and the agents it reached, so you can debug it and replay it.
Get started
- 1
Set up the agent
Copy the starter prompt into your coding agent, like Claude Code, Cursor or Codex. It creates a Trigger.dev project and adds the webhook endpoint. Prefer to write it yourself? Start from the example above.
- 2
Add the webhook in WhatsApp
Deploy your project, or run
trigger dev, and the endpoint appears on the Webhooks page of the Trigger.dev dashboard with its URL. Add that URL in WhatsApp's webhook settings and pick the events you need. The endpoint's Copy setup prompt button gives your coding agent the exact steps. - 3
Add WhatsApp's app secret
Copy the app secret from WhatsApp. Then on the endpoint's page in the Trigger.dev dashboard, choose Set signing secret and paste it in, so Trigger.dev can check every request really came from WhatsApp.
- 4
Try it
Send a test event from WhatsApp, or use the endpoint's Test tab. It appears on the endpoint's Deliveries tab, with the agents it reached.
Related integrations
Ready to build with WhatsApp webhooks?
Declare an endpoint, deploy, and paste the URL into your provider.

