Webhooks
Webhooks overview
Receive conversation, message, rating and contact events on your own server.
Setup
Webhooks push events from Whazzup to your own server the moment something happens – a new conversation, a customer message, a rating. Create an endpoint in Whazzup under Settings → Webhooks: enter your HTTPS URL, choose the events, and save. Whazzup shows the signing secret once; store it in your server environment.
Events
conversation.createdA new conversation starts (widget, email or manually).
conversation.solvedA conversation is marked as solved.
conversation.reopenedA solved or archived conversation becomes active again.
message.createdA customer sends a message (agent messages are not sent).
rating.createdA customer rates a finished conversation (0.5–5 stars, optional comment).
contact.createdA new contact appears in your workspace.
Payloads
Every delivery is a POST request with a JSON envelope:
{
"event": "conversation.created",
"sent_at": "2026-09-13T08:00:00.000Z",
"data": { … }
}The data object depends on the event:
| Event | data fields |
|---|---|
| conversation.* | conversation_id, code, subject, status, priority, channel, customer_name, customer_email, created_at |
| message.created | conversation_id, message_id, author_name, channel, body (max. 2000 chars), created_at |
| rating.created | conversation_id, score, comment, agent_name, created_at |
| contact.created | contact_id, name, email, company, created_at |
Each request carries the headers X-Whazzup-Event, X-Whazzup-Signature and User-Agent: Whazzup-Webhooks/1.0.