Вебхуки


Вебхуки совместно с API позволят Вам быстро и легко интегрировать функционал АТС WELLtime в любую CRM-систему компании, программу бухгалтерского учёта, сайт или интернет-магазин, облачный сервис или самостоятельно разработанное ПО.

Данные передаются по средствам HTTP в POST запросе, непосредственно в теле запроса(raw body) в виде JSON-объекта.

Подписка на Вебхуки и выбор событий осуществляется в соответствующем модуле

Пример JSON отправляемого запроса для события "Входящий вызов поступил на внутренний номер":

{
"event_type" : "PhoneCallStart", // тип события
"CallerID" : "88123726999", // номер звонящего
"InternalNumber" : "105", // внутренний номер, на который пришел звонок
"CallId" : "1558804165.161567", // уникальный идентификатор звонка
"Did" : "74951059995" // городской номер, на который поступил звонок
"DateTime" : "30-04-2019 14:46:34", // дата и время события в формате DD-MM-YYYY HH:mm:ss
"UnixTime" : "1556624794", // дата и время события в формате unix time
}


Поддерживаются следующие виды событий телефонии:

  • Начало входящего вызова на АТС
  • Завершение входящего вызова на АТС
  • Входящий вызов поступил на внутренний номер
  • Внутренний номер ответил на входящий вызов
  • Завершение входящего вызова на внутренний номер
  • Начало входящего вызова на короткий номер
  • Короткий номер ответил на входящий вызов
  • Завершение входящего вызова на короткий номер
  • Начало исходящего вызова
  • Ответ на исходящий вызов
  • Завершение исходящего вызова
  • Входящий вызов поступил в очередь
  • Входящий вызов поступил в очередь на оператора
  • Оператор не ответил на вызов в очереди (произошла итерация)
  • Ответ на входящий вызов в очереди
  • Завершение входящего вызова в очереди (если сработал таймаут)
  • Перевод звонка с сопровождением (средствами АТС)
  • Слепой перевод звонка (средствами АТС)

Типы событий и описание их параметров

Входящие звонки:

InboundCallStart - начало входящего вызова на АТС
CallerID - номер звонящего (клиента)
Did - городской номер, на который звонит клиент
CallId - уникальный идентификатор звонка
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

InboundCallEnd - завершение входящего вызова на АТС
CallerID - номер звонящего (клиента)
Did - городской номер, на который звонит клиент
CallId - уникальный идентификатор звонка
Answered - был ли ответ на звонок? (1 - да, 0 - нет)
InternalNumber - внутренний номер. Последний ответивший, либо последний звонивший внутренний номер. Если параметр пустой - звонок не приходил не на один внутренний номер. Если звонок пришел в очередь со стратегией "Одновременно всем" и не был отвечен - параметр будет пустой
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

Внутренние номера (SIP или FMC):

PhoneCallStart - входящий вызов поступил на внутренний номер
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

PhoneCallAnswer - внутренний номер ответил на входящий вызов
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
Record - была ли запись разговора? (1 - да, 0 - нет)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

PhoneCallEnd - завершение входящего вызова на внутренний номер
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Answered - был ли ответ на звонок? (1 - да, 0 - нет)
Did - городской номер, на который звонит клиент
Record - была ли запись разговора? (1 - да, 0 - нет)
Duration - общая длительность звонка (в секундах)
Billsec - время разговора (в секундах)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

Короткие номера (на номер или SIPURI):

FwCallStart - начало входящего вызова на короткий номер
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
Dest - номер или SIPURI, на который ушла переадресация
InternalCall - Тип звонка на короткий номер (1 - внутренний, 0 - внешний)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

FwCallAnswer - короткий номер ответил на входящий вызов
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
Dest - номер или SIPURI, на который ушла переадресация
Record - была ли запись разговора (1 - да, 0 - нет)
InternalCall - Тип звонка на короткий номер (1 - внутренний, 0 - внешний)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

FwCallEnd - завершение входящего вызова на короткий номер
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Answered - был ли ответ на звонок? (1 - да, 0 - нет)
Did - городской номер, на который звонит клиент
Dest - номер или SIPURI, на который ушла переадресация
Record - была ли запись разговора? (1 - да, 0 - нет)
Billsec - время разговора (в секундах)
InternalCall - Тип звонка на короткий номер (1 - внутренний, 0 - внешний)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

Исходящие звонки:

OutboundCallStart - начало исходящего вызова
InternalNumber - внутренний номер
CalledNumber - внешний номер, на который произведён вызов
CallId - уникальный идентификатор звонка
Did - городской номер, через который звонит оператор
IsRedirect - это вызов через короткий номер? (1 - да, 0 -нет)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

OutboundCallAnswer - ответ на исходящий вызов
InternalNumber - внутренний номер
CalledNumber - внешний номер, на который произведён вызов
CallId - уникальный идентификатор звонка
Did - городской номер, через который звонит оператор
Record - была ли запись разговора? (1 - да, 0 - нет)
IsRedirect - это вызов через короткий номер? (1 - да, 0 -нет)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

OutboundCallEnd - завершение исходящего вызова
InternalNumber - внутренний номер
CalledNumber - внешний номер, на который произведён вызов
CallId - уникальный идентификатор звонка
Did - городской номер, через который звонит оператор
Answered - был ли ответ на звонок? (1 - да, 0 - нет)
Record - была ли запись разговора? (1 - да, 0 - нет)
Duration - общая длительность звонка (в секундах)
Billsec - время разговора (в секундах)
IsRedirect - это вызов через короткий номер? (1 - да, 0 -нет)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

Звонки в очередях (только входящие)

QueueCallStart - входящий вызов поступил в очередь
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

QueuePhoneCallStart - входящий вызов поступил в очередь на оператора
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
CallId - уникальный идентификатор звонка
InternalNumber - внутренний номер
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

QueuePhoneCallNoAnswer - оператор не ответил на вызов в очереди (произошла итерация)
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
CallId - уникальный идентификатор звонка
InternalNumber - внутренний номер
Did - городской номер, на который звонит клиент
RingTime - время, которое звонил телефон у оператора (время итерации, в секундах)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

QueueCallAnswer - ответ на входящий вызов в очереди
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

QueueCallEnd - завершение входящего вызова в очереди (если сработал таймаут)
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
InternalNumber - внутренний номер
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
Answered - был ли ответ на звонок? (1 - да, 0 - нет)
Record - была ли запись разговора? (1 - да, 0 - нет)
Billsec - время разговора (в секундах)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

QueueCallMissed - упущенный вызов в очереди (клиент не дождался ответа и положил трубку)
Queue - имя очереди (латиница)
QueueId - идентификатор очереди
QueueNumber - номер очереди
CallerID - номер звонящего (клиента)
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
RingTime - сколько секунд клиент ждал ответ в очереди
CallPath - путь звонка (последовательность обзвона операторов в очереди, например: 100,101,102)
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

Переводы звонков (средствами АТС)

AttendedTransferStart - перевод звонка с сопровождением
CallerID - номер звонящего (клиента)
From - номер переводящего звонок
To - номер, на который переводят звонок
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

BlindTransferStart - слепой перевод звонка
CallerID - номер звонящего (клиента)
From - номер переводящего звонок
To - номер, на который переводят звонок
CallId - уникальный идентификатор звонка
Did - городской номер, на который звонит клиент
DateTime - дата и время события в формате DD-MM-YYYY HH:mm:ss
UnixTime - дата и время события в формате unix time

5.0(Всего оценок: 1)