Webhooks
Get notified when something happens.
Add an endpoint under Developers → Webhooks and choose events:
| Event | When |
|---|---|
conversation.created |
A new conversation starts |
handover.requested |
A customer needs a human |
agent.replied |
A team member replied from the inbox (deliver it on your own channel) |
lead.created |
The agent saved a lead |
question.unanswered |
The agent could not answer from your knowledge |
credits.low |
Your balance fell below the warning threshold |
Every delivery is a POST with JSON:
{
"id": "evt_Xk2…",
"event": "lead.created",
"created_at": "2026-09-11T10:15:00+06:00",
"data": { "lead_id": 88, "name": "Tanvir", "phone": "01811000000", "requirement": "Black panjabi L" }
}
Verify the X-SKO-Signature header exactly like business tools, using the endpoint's own signing secret. Reply with any 2xx within 6 seconds; failures are logged in the dashboard.