Webhooks
Webhook
Webhooks provide instant notifications when your phone calls are completed.
Set up custom automations on your end when you receive webhook events from Volubile.
Configure webhook
Provide the Webhook URL
where you want Volubile to send notifications in the Integration Settings
Webhook payload
Once a call is completed or fails, a POST
request will be sent to your Webhook URL
with the details of the call. Same as Get a call endpoint.
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"phone": "+33612345678",
"type": "INBOUND",
"duration": 360,
"startTime": "2024-07-30T14:35:00Z",
"endTime": "2024-07-30T14:41:00Z",
"status": "IN_PROGRESS",
"extractors": [
{
"name": "customer",
"value": [
{
"name": "firstname",
"value": [
"John"
]
},
{
"name": "lastname",
"value": [
"Doe"
]
},
{
"name": "address",
"value": [
"123 Main St"
]
}
]
},
{
"name": "example",
"value": [
"example1",
"example2"
]
}
],
"classifiers": [
{
"name": "Customer's request",
"value": "Refund",
"type": "PRIMARY"
},
{
"name": "Sentiment",
"value": "Positive",
"type": "SECONDARY"
}
],
"context": {
"firstName": "firstname",
"lastName": "lastname",
"commandNumber": "5HZ99FRT",
"system.phone": "+33612345678"
},
"summary": "Discussed project requirements and next steps.",
"created": "2024-07-30T14:45:00Z"
}
Securing webhook
You can choose to enable security for webhooks by generating a secret in the Integration Settings.
When enabled, we will include an X-Webhook-Signature
in the request headers to your Webhook URL
allowing you to verify that the payload originated from Volubile.
Below is sample code demonstrating how to verify the HMAC signature
: