Вебхуки (Webhooks) – это метод передачи данных, который позволяет отправлять события в реальном времени от одной системы к другой. 

В нашем случае, вебхуки используются для отправки уведомлений о звонках от call-tracking.by к другим системам. Данная документация предназначена для разработчиков, которые хотят интегрировать нашу систему с другой системой с помощью вебхуков.


Для того, чтобы настроить получение уведомлений, вам необходимо в кабинете marketplaces.сall-tracking.by перейти на вкладку "Интеграции" и заполнить необходимые поля.



Настройка вебхуков для отправки уведомлений о звонках


1. Настройте URL-адрес конечной точки на который будут отправляться уведомления о звонках. Заполняйте только поля только для тех типов событий который вы хотите получать. События для которых не указан адрес отправляться не будут.

2. Выберите подходящий HTTP-метод для отправки уведомлений.

3. Отметьте чекбокс  "Активироть интеграцию" чтобы интеграция начала работать.


4. Нажмите "Отправить", чтобы сохранить изменения.



Формат события


На указанный адрес вам будут отправлены следующие параметры:

{
  "event": "call_end",
  "caller":  "+375290000000",
  "receiver": "+375297777777",
  "time": "2025-05-01T15:24:49+03:00",
  "pbx_id": "1557491089.930439",
  "duration": 121,
  "audio_path": "https://vrecords.call-tracking.by/monitor/record_path"
}
Название
Тип
Описание
event
string
Возможные значения: call_start, call_answer, call_end
caller
string
Номер звонившего
receiver
string
Номер куда звонили
time
string
Время в формате iso8601
pbx_id
string
Уникальный идентификатор звонка
duration
int
Продолжительность звонка в секундах. Только для event = call_end. Если звонок не был отвечен - 0.
audio_path
string
Ссылка на запись разговора. Запись по ссылке доступна, пока запись хранится в личном кабинете (исходя из настроек хранения записей в личном кабинете клиента). Только для event = call_end.