В некоторых случаях интеграция требует получения уведомлений в режиме реального времени о звонке. В качестве примера можно привести показ карточки звонка в CRM системе (для таких CRM систем как АМО и Bitrix24 у нас есть готовые системы интеграции). Для решения таких задач система SipSim.by может уведомлять ваши сервера специальными запросами при начале звонка, ответе оператора и завершения звонка.
Для того, чтобы настроить получение уведомлений вам необходима пара простых шагов:
ШАГ 1: зайти на страницу интеграций и нажать на "Подключить".
ШАГ 2: Заполнить адреса ваших серверов для уведомления. Так же вы можете выбрать метод, который будет использоваться при запросе.
На указанные адреса вам будут отправлены следующие параметры:
- event - название события;
- time - время в формате iso8601;
- pbx_id - Уникальный идентификатор звонка;
- duration - продолжительность звонка;
- caller - номер звонящего;
- receiver - номер принимающего;
- status - статус звонка;
- audio_path - Ссылка на запись разговора. Присутствует, если запись включена. Запись хранится в соответствии с настройками пользователя.
Список событий:
incoming_call_start - начало входящего звонка incoming_call_start_chain_member_call - начало вызова номера в цепочке дозвона incoming_call_end_chain_member_call - конец вызова номера в цепочке дозвона incoming_call_answer - ответ на звонок incoming_call_end - окончание звонка _____________________________________________________________________ outgoing_call_start - начало исходящего звонка outgoing_call_answer - ответ на звонок outgoing_call_end - окончание звонка
Список статусов
cancel - отмена answer - ответ noanswer - нет ответа busy - занят unavailable - недоступен other - ошибка
Для событий окончания звонка справедливы только статусы "answer" и "noanswer". Для отслеживания статуса конкретного менеджера необходимо пользоваться статусами для событий "incoming_call_end_chain_member_call".
Пример входящего звонка:
Вызов поступает на номер отдела, далее начинается цепочка обзвона, менеджер 1 и 2 заняты, менеджер 3 ответил.
Входящие звонки
ВАЖНО:
Параметр "receiver" будет меняться в зависимости от номера на который поступает звонок в данный момент. Так при звонке на номер отдела внутри которого звонки распределяются по менеджерам параметр "receiver" будет номером отдела для событии incoming_call_start и incoming_call_end, но при этом - номером конкретного менеджера для событий incoming_call_start_chain_member_call, incoming_call_end_chain_member_call, incoming_call_answer
Начало звонка:
{
"event" => "incoming_call_start",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001"
}Начало вызова номера в цепочке дозвона:
{
"event" => "incoming_call_start_chain_member_call",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001"
}Конец вызова номера в цепочке дозвна:
{
"event" => "incoming_call_end_chain_member_call",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001",
"status" => "NOANSWER"
}Ответ на звонок:
{
"event" => "incoming_call_answer",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001"
}Окончание звонка:
{
"event" => "incoming_call_end",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"duration" => "102.0",
"caller" => "+375290000000",
"receiver" => "+375290000001",
"status" => "NOANSWER",
"audio_path" => "https://vrecords.call-tracking.by/monitor/XXXXXXX"
}Исходящие звонки
Начало звонка:
{
"event" => "outgoing_call_start"
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001"
}Ответ на звонок:
{
"event" => "outgoing_call_answer"
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"caller" => "+375290000000",
"receiver" => "+375290000001"
}Окончание звонка:
{
"event" => "outgoing_call_end",
"time" => "2020-04-06T05:28:15.174Z",
"pbx_id" => "1557491089.930439",
"duration" => "102.0",
"caller" => "+375290000000",
"receiver" => "+375290000001",
"status" => "NOANSWER",
"audio_path" => "https://vrecords.call-tracking.by/monitor/04ec5d3b",
}