Wawp’s Webhook API makes WhatsApp events stream in real-time to your automation flows — so you can capture, process, and react instantly with n8n, Zapier, or any custom server endpoint.By forwarding messages, reactions, status updates, and more, webhooks turn Wawp into a live event source for your workflows.Before you can receive events, you must:1.
Set up a webhook listener (for example in n8n, Zapier, or your own Node.js/PHP server). 2.
Tell Wawp where to send events by configuring the webhook in your Wawp account.
By exposing consistent event payloads, Wawp eliminates polling and provides a clean, scalable integration path. Developers can filter which events they need, and operators benefit from retry policies that guarantee delivery even if their server is temporarily offline.Documenting webhook use on https://docs.wawp.net with examples, failure retries, and event types ensures fast adoption and fewer integration issues.
Next, you need to tell your Wawp account where to send the event data:2.
Go to the Connected Numbers area.
3.
Click the Webhook button on your number’s instance card.
4.
In the popup, click Add New Webhook.
5.
Webhook URL: Paste the Production URL from your Wawp Trigger node in n8n (or your Zapier/custom server endpoint).
Retry Policy: Choose how often Wawp retries on failure (e.g., every 5 seconds).
Events to Receive: Select event types (e.g., messages
, reactions
) to avoid unnecessary traffic.
⚠️ The webhook URL must be publicly accessible. Localhost links won’t work — use n8n Cloud or a self-hosted instance with a domain.
📦 Example Webhook Payload#
{
"instance_id": "123456789",
"event": "message",
"data": {
"from": "200000000001@c.us",
"to": "200000000002@c.us",
"body": "Hello, world!",
"timestamp": 1722170400
}
}
Modified at 2025-09-29 02:09:35