Webhook

Real-time webhooks for every event

Receive delivery receipts, incoming messages and status changes instantly. A single endpoint for WhatsApp, SMS and Email.

Webhook Manager: receive every event in real time

Chat API's Webhook Manager lets you register an HTTPS endpoint on your server and receive instant notifications for every event generated by your messaging channels: incoming WhatsApp messages, delivery confirmations, read receipts, SMS status updates, email opens and much more.

Unlike traditional polling, with webhooks you don't need to continuously query the APIs to know if something has happened. The event arrives directly to your server in milliseconds, with a structured JSON payload and an HMAC SHA-256 signature to verify the authenticity of each request.

The system is designed for maximum reliability: if your endpoint is unavailable, the Webhook Manager automatically retries delivery with exponential backoff, ensuring no event is ever lost. Each attempt is logged with the payload, status code and response time, making debugging simple and fast.

Features

Everything you need to manage webhooks

A robust and reliable system to receive real-time events from all your channels.

Real-time delivery

Events delivered instantly to your endpoint as soon as they occur. No polling, no delay.

Retry logic

Automatic retries with exponential backoff on failure. No event lost, ever.

Event filtering

Subscribe only to the events you need. Reduce noise and optimize your server.

HMAC signature

Every webhook is signed with HMAC SHA-256. Verify the authenticity of every incoming request.

Logs & debugging

Detailed logs for every event sent. View payload, status code and response times.

Multi-channel

Unified events from WhatsApp, SMS and Email in a single endpoint. One format, three channels.

How it works

Setup in 3 steps

From endpoint to event reception in minutes.

1

Setup

Configure endpoint

Register your server URL that will receive events. Supports HTTPS with certificate verification.

2

Filter

Select event types

Choose which event types to receive: incoming messages, delivery confirmations, status changes and more.

3

Live

Receive in real-time

Events arrive at your endpoint in milliseconds with complete JSON payload and HMAC signature.

Payload example

Structured JSON payload

Every webhook event is delivered with a clear and consistent JSON payload. Easy to parse, easy to integrate.

message.receivedmessage.deliveredmessage.readmessage.failedtemplate.approved
POST → your-server.com/webhook
{
  "event": "message.received",
  "channel": "whatsapp",
  "timestamp": "2026-03-14T10:30:00Z",
  "data": {
    "from": "+39123456789",
    "message": "Hello!",
    "type": "text"
  }
}

99.99%

Uptime

<200ms

Delivery

50M+

Events / month

3

Channels

Frequently asked questions about Webhook Manager

What is a webhook and how does it work?
A webhook is an HTTP notification that Chat API's server sends to your endpoint whenever an event occurs (e.g. message received, delivery confirmed). Your server doesn't need to do anything special: just expose an HTTPS URL that accepts POST requests in JSON format.
How can I verify that webhook requests are authentic?
Every webhook request includes a signature header calculated with HMAC SHA-256 using your account's secret key. Compare the received signature with the one you calculate on your side: if they match, the request is authentic and hasn't been tampered with in transit.
What happens if my endpoint is unavailable?
The Webhook Manager automatically retries delivery up to 5 times with exponential backoff (5s, 25s, 125s, 625s, 3125s). If all attempts fail, the event is recorded as undelivered in the system log, where you can analyze it and trigger a manual redelivery.
Can I filter events to receive only the ones I need?
Yes. When configuring your webhook you can select exactly which event types you want to receive: message.received, message.delivered, message.read, message.failed, template.approved and others. This reduces traffic to your server and simplifies your processing logic.
Does Webhook Manager work with all channels?
Yes. A single endpoint receives events from all three channels: WhatsApp, SMS and email. The JSON payload always includes a 'channel' field identifying the event source, letting you handle all channels with a single application logic.
Webhook Manager

Ready to receive events in real-time?

Configure your first webhook in minutes. No credit card required.