Dynamic assistant configuration webhook
Webhook
POSTassistant-request
Webhooks
Last modified:2026-03-12 10:32:36
Maintainer:Jesper Rietbergen
Response Modes
{}{
"assistant": {
"first_message": "Hello John!",
"tts_config": {"voice_id": "..."},
"metadata": {"crm_id": "12345"}
}
}{
"assistant_id": "uuid-of-saved-agent",
"assistant_override": {
"tts_config": {"voice_id": "female-voice"},
"first_message": "Hello John!",
"metadata": {"crm_id": "12345"}
}
}assistant_override completely replaces that config block from the saved agent.Custom Metadata
metadata) will be echoed back in all subsequent webhook events (status-update, tool-calls, end-of-call-report). This is useful for passing CRM IDs, campaign info, or any context you need.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
"message": {
"type": "assistant-request",
"timestamp": "2019-08-24T14:15:22.123Z",
"call": {
"id": "5c4d030f-43e3-4e65-899e-8148521e660f",
"type": "inbound_phone_call",
"status": "ringing",
"pipeline": "standard"
},
"phone_number": {
"number": "+31850835037",
"name": "HMS Sovereign Demo"
},
"customer": {
"number": "+31612345678"
}
}
}'Response Response Example
Default mode (use saved config)
{}Modified at 2026-03-12 10:32:36