Webhooks
/ Get a POST to your server when a conversation escalates, closes, or trips a business signal.
What they are for
Webhooks let your backend react on its own: open a Linear issue, ping Slack, fire a Stripe retention coupon, page on-call when a hospitality chat goes critical.
Coming soon. Set up endpoints under Dashboard, then Integrations, then Webhooks.
The payload
POST your-endpoint.com/humaner
{
"event": "conversation.escalated",
"agentId": "ag_demo123",
"conversationId": "conv_abc",
"payload": {
"reason": "unanswered_question",
"lastMessage": "Can I speak to someone?"
}
}| Event | Fires when |
|---|---|
| conversation.escalated | The agent gives up, or the customer asks for a human |
| conversation.closed | The session ends and a summary is ready |
| metadata.cancellationIntent | A cancel intent is detected |
| metadata.urgency critical | An emergency. Fires before the reply |