Webhooks are user-defined callbacks that are triggered by specific events. They assist in starting the execution of a specific task when specific actions occur and pushing data from one application or server to another when an event occurs (also called trigger). Furthermore, they respond in real-time, eliminating delays in accessing critical information. You can configure Webhook by specifying the HTTP Method, the URL to receive data, and the trigger options, which are all detailed below.

To add a webhook, follow these steps:

  1. Click on Services > Webhook tab placed on the side-navigation.

  2. Click on Add Webhook on top-right of the page.

Webhook 1

  1. Enter the general details as per the fields described in the table below.

Webhook 2

FieldDescription
NameEnter the name of the Webhook.
DescriptionEnter the description for Webhook.
TriggerChoose the trigger from the dropdown. A trigger is a predefined action or a notification that activates Webhook.
The triggers or automated processes listed below are generated for both inbound and outbound calls, and they are as follows:
  • Call received on server
  • Call answered on IVR
  • Call answered on ring group
  • Call answered on call queue
  • Call answered by extension
  • Call missed
  • Call hangup
  • Call missed or answered
  • DTMF option
  • Dialed on extensions
  • Call answered by customer(Click to Call)
URLEnter the URL that will be used to provide HTTP callbacks for the Webhook.
RequestSelect request from either of the following options: POST or GET.
Note: The exchange of data happens over the web through an HTTP request, using GET & POST methods.
Call TypeSelect the required Call Type from either of the following options:
  • Inbound
  • Outbound
  • Click to Call
  • Content-TypeSelect the Content-Type that contains the data from either of the following body types:
  • application/x-www-form-urlencoded: The content body is in HTML format.
  • application/json: The content body is in JSON format.
  • My NumbersSelect the DID numbers from the dropdown.
    Time ZoneSelect the time zone for the webhook.

    Note: While configuring the triggers, Webhook sends an HTTP request encompassing various parameters to different endpoints. These parameters form the Response Body as demonstrated in the screenshot. Also, the parameters change as per the selected trigger.

    Webhook 3

    1. Click Add header to add new header, enter the Key and the Value to insert additional values in the Response Body.

    Webhook 4

    1. Click Save.