Configuring the REST Event API (Webhooks)

The service can connect to your own applications if they support a REST type API.

Functionalities offered

The events that can be notified to your applications are the following:

• Incoming calls.
• Outgoing calls.
• Call answering by extensions.
• Get a contact name.
• Completed calls.
• Call transfers.
• Get HTML for browser extension (Chrome).

How to make the configuration

The REST API integration allows you to receive notifications of events occurring in the virtual PBX in your own applications so that you can make your own integrations.

For each event you will have to configure the URL of the web service that will receive the notification, as well as the HTTP method with which you want the request to be made (GET,POST, PUT or DELETE).

If you use GET or DELETE, you will have to indicate the parameters to be replaced in the URL itself. In the case of POST and PUT the parameters will have to be indicated in the new data field of the request that will appear next to the field of the URL.

For example, to receive a GET notification of an incoming call event you should set something similar to the following URL:

• https://yourdomain.com/test_ws.php?callid={id}&caller={src}&numcalled={dst}

For POST requests, a structure similar to this would be used:

• https://sudominio.com/test_ws.php

{
	"id": "{id}"
    "dst": "{dst}",
    "call_id": "{call_id}"
}

It is necessary that the response comes encoded in json (use json_encode in php, for example).

To activate it, access the PBX panel > Integrations and search for Webhooks, activate the integration [OFF/ON] and click on “Change configuration”.

Events

The different events and respective parameters you can use are as follows:

When making an incoming call

This event is called every time a new call is received at a public number.

Parameters:

• {id}: unique caller ID.
• {src}: caller’s number.
• {dst}: public number called.
• {call_id}: Call ID.

When making an outgoing call

This event will be called each time a new outgoing call is made.

Parameters:

• {id}: unique caller ID.
• {src}: caller ID used.
• {dst}: phone number called.
• {ext}: extension that originated the call.
• {call_id}: Call ID.

When answering a call

This event will be called every time a call is answered by an extension.

Parameters:

• {id}: unique caller ID.
• {ext}: extension that has answered the call.
• {call_id}: Call ID.

Get a contact name

This event is called to get the name of the contact from a phone number. This name will be used to display on your terminal when you make or receive a call. The response from your API should be the name of the contact in plain text.

Parameters:

• {number}: Caller’s number.

When hanging up the call

This event will be called every time a call is hung up.

Parámetros:

• {id}: unique caller ID.
• {duration}: duration of the call in seconds.
• {src}: Caller's number.
• {dst}: Called phone number.
• {direction}: Inbound/Outbound direction.
• {call_id}: Call ID.

When transferring a call

This event will be called each time a call is transferred.

Parameters:

• {id}: unique caller ID.
• {duration}: duration of the call in seconds.
• {ext}: Extension or external number to which the call has been transferred.
• {call_id}: Call ID.

Get HTML

This event is called by the browser extension (Chrome) to get the contact information displayed from a phone number. This information will be used to display in the Chrome browser when you make or receive a call. The response from your API should be the content of the HTML body.

Parámetros:

• {number}: Número del llamante.