Наверх
Подписаться

Интеграция со сторонними АТС

Если Вы желаете использовать собственные телефонные номера для отслеживания источников звонков, настроенные в Вашей АТС, Calltouch может с легкостью интегрироваться с ней!

Интеграция производиться с помощью Calltouch Event Register Service. Для настройки интеграции Вам необходимо отправить заявку Вашему личному аккаунт-менеджеру Calltouch либо на почту info@calltouch.net, после чего мы произведем необходимые настройки с нашей стороны и вышлем Вам авторизационный ключ (apikey) для доступа в нашу АТС.

После настройки интеграции с Вашей АТС, при поступлении звонка на Ваш номер, Ваша АТС будет должна отправлять события с помощью Calltouch Event Register Service в наш сервис, содержащие всю информацию о поступившем звонке, а Calltouch на своей стороне будет склеивать эту информацию со своими данными о посетителе на сайте, которому был выделен в этот момент времени номер, на который поступил звонок. Таким образом Calltouch установит источник звонка.

 

Схема работы

 

Описание схемы работы

  1. Абонент совершает телефонный вызов на виртуальный номер АТС.
  2. Во время обработки звонка АТС, внутренний сервис АТС генерирует N-ое количество уведомлений/событий, в зависимости от происходящего на телефонной линии абонента.
  3. Каждое из этих событий ATS Service отправляет Calltouch Event Register Service. Типы отправляемых/игнорируемых для отправки событий (присвоение им кодов) обсуждаются с каждым из операторов индивидуально.
  4. Calltouch Event Register Service регистрирует во внутренней системе принятое событие и отправляет ответ в виде JSON (содержит уникальный идентификатор события в системе Calltouch).
  5. Далее идет обработка принятого события внутренними сервисами Calltouch.

 

Описание внешнего интерфейса Calltouch Event Register Service

Код события Описание Входящее /Исходящее Комментарий
callconnected АТС приняла звонок АТС INBOUND  
call Начало звонка оператору АТС OUTBOUND  
connected Звонок клиента с оператором соединен АТС OUTBOUND  
disconnected Звонок клиента с оператором разъединен АТС OUTBOUND  
callfailed Звонок завершен неудачно АТС INBOUND  
failed Звонок завершен неудачно АТС OUTBOUND  
calldisconnected Звонок завершен успешно    
clienttonereceived Клиент передал DTMF-сигнал   Передается во время сеанса связи
operatortonereceived Оператор передал DTMF-сигнал   Передается во время сеанса связи

 

Обратите внимание! Чтобы в статистике Calltouch отобразился звонок, необходимым условием является передача двух событий:

  • callconnected
  • calldisconnected или failed

 

Параметры, передаваемые в запросе

Название параметра Тип Обязательный Описание Формат
apikey Строка Да Приватный ключ АТС (выдается по запросу в техническую поддержку info@calltouch.net).  
action Строка Да Уникальный код события, которое произошло в момент обработки звонка абонента.  
callid Строка Да Уникальный идентификатор звонка (в системе АТС).  
callerid Строка Да Идентификатор абонента (номер абонента) при событии соединения. 7495241XXXX или 7495241XXXX#4 или #4
sessionid Строка Да Уникальный идентификатор сессии вызова (в системе АТС).  
phonenumber Строка Да Номер переадресации/виртуальный номер, в зависимости от этапа вызова (кода события). 7495241XXXX
callrecordurl Строка Нет URL для получения записи звонка (передается после завершения звонка).  
attributes Массив Нет Дополнительные атрибуты. Произвольный набор параметров.  

 

Все запросы, принимаемые Calltouch Event Register Service, обрабатываются по адресу:

http://atsX.calltouch.ru/event-service/platform/ATS_CODE/inbound-call

где:

  • X - номер АТС
  • ATS_CODE - уникальный идентификатор АТС в системе Calltouch

Оба параметра выдаются по запросу в техническую поддержку info@calltouch.net.

 

Передача дополнительных параметров

К любому передаваемому событию можно передать произвольный набор данных. Для этого необходимо заполнить параметр запроса attributes в следующем формате:


...attributes[ИМЯ_ ПАРАМЕТРА_1]=ЗНАЧЕНИЕ_1&attributes[ИМЯ_ ПАРАМЕТРА_2]=ЗНАЧЕНИЕ_2...


Пример: attributes[reasoncode]=INVALID_CALL_REFERENCE&attributes[statuscode]=FAILED

 

Передача DTMF сигналов

Передача DTFM сигналов происходит с помощью событий:

  • clienttonereceived
  • operatortonereceived

При этом, код DTFM сигнала передается в параметре callerid, в одном из двух форматов:

  • НОМЕР_ТЕЛЕФОНА#DTMF_КОД
  • #DTMF_КОД

Примеры:

  • callerid=7495241XXXX#4
  • callerid=#2

 

Примеры запросов

Общие запросы

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=callconnected&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX&phonenumber=7495661XXXX

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=call&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX&phonenumber=7495241XXXX

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=connected&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX&phonenumber=7495241XXXX

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=disconnected&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX&phonenumber=7495241XXXX

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=calldisconnected&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=a9dab38431ee5499.1433950083.524354&callerid=7495577XXXX
&phonenumber=7495241XXXX&callrecordurl=http%3A%2F%2Frecord_id%3Da9dab38431ee5499.1433950083.524354

 

Передача дополнительных параметров

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=disconnected&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX&phonenumber=7495241XXXX&attributes[da]=778&attributes[statuscode]=FAILED
&attributes[displaycode]=%D0%BD%D0%B5%D1%83%D0%B4%D0%B0%D1%87%D0%BD%D0%B9%20%D0%

 

Передача DTFM-сигналов

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=clienttonereceived&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX#3&phonenumber=7495241XXXX

http://ats.calltouch.ru/event-service/platform/zzz/inbound-call?action=operatortonereceived&apikey=XXXX
&sessionid=a9dab38431ee5499.1433950083.524354&callid=8McwWvHWSe_5_2VnE56O6SKhDIy3UUEbn_QZM5jha2w
&callerid=7495577XXXX#3&phonenumber=7495241XXXX

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 0 из 0
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.