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 :