Webhooks
Receive a client's chat and call events on your own endpoint, signed and verifiable
Receive real-time chat and call events on your own server — Happ POSTs JSON when something happens, so you can drive Slack alerts, CRM lookups, analytics, or custom workflows.
Connect
- Open the Integrations catalog and click Connect on Chat webhook or Call webhook.
- In the modal, enter your Webhook URL — the HTTPS endpoint that receives events.
- Optionally set a Webhook secret for request verification.
- Click Connect.
There's no separate webhooks page, no event-subscription toggles, and no in-app deliveries log — the modal is just URL + optional secret.
Events sent
| Webhook | Fires on |
|---|---|
| Chat | Every message in a watched chat — from the customer, from the assistant, and from an operator |
| Call | End of a call — a single post-call delivery with duration, metadata and the recording URL when there is one |
Verifying requests
Set a webhook secret and every delivery carries two headers:
| Header | Value |
|---|---|
Authorization | Basic <secret> — your secret verbatim, not base64 of user:password |
X-Signature | sha256=<hex> — HMAC-SHA256 of the raw request body, computed with your secret |
Verify by recomputing HMAC-SHA256 over the raw body (before parsing the JSON) and comparing in constant time. If your platform gives no access to the raw body, check the Authorization header instead. With no secret set, neither header is sent. Same mechanism as assistant tools.
Use HTTPS only, respond 200 fast (process async), and handle duplicate deliveries idempotently.
Webhooks vs tool webhooks
| Integration webhooks | Tool webhooks | |
|---|---|---|
| Trigger | Automatic on events | Called by AI during conversation |
| Direction | Happ → your server | Happ → your server → response → AI |
| Response | HTTP 200 ack | JSON used by the assistant |
| Use case | Monitoring, logging, alerting | Dynamic lookups, actions |
For webhooks the AI calls mid-conversation, see Tools.
Next
- Tools — AI-called webhooks
- Notifications — built-in alerting
- Integrations — the full catalog
Help me solve it
Happ answers right away and hands over to a manager when needed.