Learn how to configure Webhooks in Wawp to listen to real-time WhatsApp events, leverage the System Event Monitor for debugging, and see integration examples for Zapier, n8n, Make, and Pipedream.
6 min read·Updated June 18, 2026
Introduction to Webhooks
A Webhook is an automated message sent by Wawp to your external systems or third-party applications when an event occurs. Instead of your server constantly polling Wawp's API to check for updates (which consumes resources and introduces delays), Wawp pushes the data instantly to a unique URL you specify.
For instance, when a customer sends a WhatsApp message to your number, Wawp captures this event in real-time and immediately sends an HTTP POST request containing the message payload directly to your configured webhook URL.
What is the System Event Monitor?
The System Event Monitor is a powerful logging and diagnostic dashboard built directly into Wawp. It acts as a black box flight recorder for your outbound communications.
Key Benefits:
Real-Time Visibility: Watch webhook dispatches as they happen, showing you the target URL, execution timestamp, and response speed.
Error Tracking & Response Codes: Easily identify failures. If your integration is returning error codes (like 500 Internal Server Error or 404 Not Found), the monitor flags it immediately.
Payload Inspection: View the exact JSON data sent by Wawp and the exact response headers returned by your server.
Event Retry/Replay: If your server goes offline temporarily, you don't lose messages. You can use the Event Monitor to retry sending the failed webhook payload with a single click once your service is back online.
Message Status Lifecycle & Analytics
Understanding the status of each message helps you monitor the health of your customer communications:
❌ Failed (Failed): The message could not be sent (e.g., the recipient number does not exist on WhatsApp, or there is an API configuration issue).
📤 Sent (Sent): The message successfully left Wawp and was received by WhatsApp servers.
📩 Delivered (Delivered): The message arrived at the recipient's phone (displays as double checkmarks on WhatsApp).
👁️ Read (Read): The recipient opened and read the message (displays as blue checkmarks).
Why tracking these metrics is highly beneficial:
Delivery Analytics: Measure your open rates and click-through rates (CTR) to evaluate campaign performance.
Contact List Validation: Instantly clean up your database by identifying dead or invalid phone numbers (which return a Failed status).
Smart Follow-up Workflows: Trigger automated responses based on actions. For example, in n8n or Zapier, you can configure a flow that waits 2 hours and sends a follow-up only if the status of the first message is Delivered but not yet Read.
How to Set Up a Webhook in Wawp
Follow these quick steps to hook up your first webhook receiver:
1
Get Endpoint URL Create or copy the webhook reception URL from your automation provider (e.g. n8n, Zapier, Make, or your custom server).
2
Access Webhook Settings Log into the[Wawp Dashboard](https://app.wawp.net/linked-numbers), open your target WhatsApp instance settings, and locate the Webhooks tab.
3
Save & Subscribe Paste your URL, toggle the event triggers you want to listen to (e.g. Received Messages, Session State Changes), and click "Save Configuration".
Webhooks Developer Documentation
🔗 For a complete overview of the webhook payload schemas, event configurations, and API definitions, visit our developer documentation: Webhooks Overview
Integration Examples Across Different Platforms
You can route Wawp events to almost any online application. Below are guides and examples for 5 popular platforms:
1. n8n Integration (Highly Recommended)
n8n is a powerful workflow automation tool that integrates natively with Wawp.
Trigger Node: In n8n, you can install the official community package @wawp/n8n-nodes-wawp.
Example Endpoint:https://your-n8n-instance.com/webhook/wawp-incoming-trigger
2. Zapier
Zapier connects Wawp to thousands of apps (like Salesforce, Google Sheets, or Slack).
Trigger: Choose Webhooks by Zapier as the App and select "Catch Hook" as the event.
Setup: Zapier generates a webhook URL. Copy it and paste it into Wawp.
Example Endpoint:https://hooks.zapier.com/hooks/catch/12345/abcde/
3. Make (formerly Integromat)
Make offers a visual builder to process complex conditionals.
Trigger: Create a new scenario, search for Webhooks, and select "Custom Webhook".
Setup: Click "Add" to generate a unique address, paste it into Wawp, and perform a test message to let Make auto-determine the JSON structure.
Example Endpoint:https://hook.us1.make.com/abcdefg123456
4. Pipedream
Pipedream is a developer-focused integration platform designed for fast serverless code execution.
Trigger: Create a new workflow, select "HTTP / Webhook" as the source, and choose HTTP POST requests.
Setup: Pipedream will provide a request URL. Paste it in Wawp. You can write Node.js or Python code blocks immediately below it to parse the incoming text.
Example Endpoint:https://eoxxx12345.m.pipedream.net
5. Custom Server (Node.js Express / Webhook.site)
For custom development, you can spin up an API endpoint or test instantly via Webhook.site.
Express Example:
Express Server Example (Node.js)
1const express = require('express');
2const app = express();
3app.use(express.json());
4
5app.post('/whatsapp-webhook', (req, res) => {
6const { event, data } = req.body;
7 console.log(`Received event: ${event}`);
8 console.log(`Message: ${data.body} from ${data.from}`);
9 res.status(200).send('Event processed');
10});
11
12app.listen(3000, () => console.log('Webhook server listening on port 3000'));
javascript sample
Ln 12, Col 1
Detailed Events and Payload Data
Wawp broadcasts specific event hooks depending on the action. Below are the key events you can subscribe to:
1. New Message Received (message)
Triggered immediately when a contact sends a text, image, document, or audio file to your WhatsApp number.
Impact: Use this to trigger chatbot replies, log conversations inside your CRM, or notify team members.
Example Payload:
New Message Received Payload
1{
2"event": "message",
3"instanceId": "wawp-instance-5582",
4"timestamp": 1781752669,
5"data": {
6"id": "true_1234567890@c.us_ABCDE12345",
7"from": "1234567890@c.us",
8"to": "0987654321@c.us",
9"body": "Hello Wawp! Need help with my order.",
10"type": "chat",
11"fromMe": false
12 }
13}
json sample
Ln 13, Col 1
2. Session Status Changed (session.status)
Fired when your connection state changes (e.g. logging out, losing internet, or starting up).
Impact: Send emergency system alerts to your developers or show offline indicators on your client dashboard.
Example Payload:
Session Status Changed Payload
1{
2"event": "session.status",
3"instanceId": "wawp-instance-5582",
4"timestamp": 1781753000,
5"data": {
6"status": "DISCONNECTED",
7"reason": "Device logged out by phone",
8"timestamp": "2026-06-18T05:20:00.000Z"
9 }
10}
json sample
Ln 10, Col 1
3. New QR Code Generated (session.qr)
Fired when a new QR code string is generated for your instance container.
Impact: Stream the QR code dynamically to custom portals, allowing remote users to scan and authenticate without accessing Wawp directly.
Example Payload:
New QR Code Payload
1{
2"event": "session.qr",
3"instanceId": "wawp-instance-5582",
4"timestamp": 1781753100,
5"data": {
6"qr": "1@aBcdEfGh...IjKlMnOpQr",
7"timeoutMs": 20000
8 }
9}
json sample
Ln 9, Col 1
By subscribing to these events, you gain total programmatic control over your WhatsApp business channel, allowing for rich, instant automated communication.
