Overview
Receive inbound messages from your customers via webhooks
Zavu delivers incoming messages to your application in real-time via webhooks. When a customer sends you a message via SMS or WhatsApp, we forward it to your configured endpoint within seconds.
How It Works
CodeCustomer Message → Zavu → Your Webhook → Your Application
- A customer sends a message to your Sender's phone number
- Zavu receives the message from the carrier (SMS) or Meta (WhatsApp)
- We forward the message to your registered webhook URL
- Your application processes the message and responds if needed
Quick Start
1. Set Up Your Endpoint
Create an endpoint that accepts POST requests. Here's a minimal example:
app.post("/webhooks/zavu", (req, res) => {
const event = req.body;
if (event.type === "message.inbound") {
console.log("New message from:", event.data.from);
console.log("Message:", event.data.text);
}
res.status(200).send("OK");
});
2. Register Your Webhook
Configure your webhook URL in the Dashboard under your Sender settings, or via the API.
3. Start Receiving Messages
Once configured, Zavu will send message.inbound events to your endpoint whenever a customer messages you.
Webhook Events
| Event | Description | Use Case |
|---|---|---|
conversation.new | New conversation started (first message from a contact) | New leads/contacts |
message.inbound | Customer sent you a message | Receiving messages |
message.queued | Your message was queued for delivery | Outbound tracking |
message.sent | Your message was sent to the carrier | Outbound tracking |
message.delivered | Your message was delivered | Outbound tracking |
message.failed | Message delivery failed | Outbound tracking |
Next Steps
- Configure Webhooks - Set up your webhook endpoints
- Event Types - Detailed event payload documentation
- Security - Verify webhook signatures