Webhooks allow you to receive real-time notifications about call events. When events occur, HMS Sovereign sends HTTP POST requests to your configured endpoint.Available Webhooks#
Configuration#
Configure webhooks on your assistant:All webhooks send POST requests with:| Header | Description |
|---|
Content-Type | application/json |
User-Assistant | HMS-Sovereign/1.0 |
X-Webhook-Event | Event type |
X-Webhook-Timestamp | Unix timestamp |
X-Webhook-Signature | HMAC-SHA256 signature |
Body Structure#
{
"message": {
"type": "status-update",
"timestamp": "2025-12-13T12:00:00.000Z",
"call": {
"id": "5c4d030f-43e3-4e65-899e-8148521e660f",
"type": "inbound_phone_call",
"status": "in-progress"
},
"phone_number": {
"number": "+31850835037",
"name": "HMS Sovereign Demo"
},
"customer": {
"number": "+31612345678"
}
}
}
Response Requirements#
| Webhook | Response Required | Timeout |
|---|
| Assistant Request | Yes (config or empty) | 5 seconds |
| Tool Calls | Yes (result) | 10 seconds |
| Status Update | No (ignored) | - |
| End of Call Report | No (ignored) | - |
Next Steps#
Modified at 2026-03-17 10:59:50
