Информация передаваемая api default
Для настройки интеграции CRM клиента с ВАТС Смарт Телеком клиенту необходимо передать в Смарт Телеком:
- url-адрес по которому будет принимать данные от api
- ключ(key) для идентификации
- id(login) пользователя crm
Передача события входящего/исходящего вызова в CRM систему посредством API вызовов следующих данных:
Значение переменных:
- «linkedid» ⇒ $linkedid - уникальный индификатор вызова;
- «srcNumber» ⇒ $srcNumber - номер звонящего;
- «dstNumber» ⇒ $did - городской номер;
- «direction» ⇒ $direction - направление вызова «in» «out» входящий или исходящий;
- «exten» ⇒ $exten - внутренний номер;
- «crmUserId»⇒$crmUserId - id- login; пользователя crm;
- «key»⇒$key - ключ;«mp3link» ⇒ $mp3Link - ссылка на файл разговора;
- «billsec»⇒$billsec - длительность вызова в секундах;
- «eventType»⇒$eventType - состояние вызова 1-начало звонка, 2- ответ/перевод/ivr/другое, 3- завершение звонка;«serverTime»⇒$serverTime - серверное время событие в unixtime;
- «dialstatus»⇒$dialstatus - состояние вызова: ANSWER, NO ANSWER, IVR, TRANSFER-CONNECTED, VEMAIL;.
В зависимости от значения eventType бывают три вида вида передаваемого запроса: При начале звонка передаются следующие параметры:
- «linkedid» ⇒ $linkedid,
- «srcNumber» ⇒ $srcNumber,
- «dstNumber» ⇒ $did,
- «direction» ⇒ $direction,
- «exten» ⇒ $exten,
- «crmUserId»⇒$crmUserId,
- «key»⇒$key,
- «mp3link» ⇒ $mp3Link,
- «billsec»⇒$billsec,
- «eventType»⇒'1',
- «serverTime»⇒$serverTime
При промежуточных событиях звонка передаются следующие параметры:
- «linkedid» ⇒ $linkedid,
- «srcNumber» ⇒ $srcNumber,
- «dstNumber» ⇒ $did,
- «direction» ⇒ $direction,
- «exten» ⇒ $exten,
- «crmUserId»⇒$crmUserId,
- «key»⇒$key,
- «dialstatus»⇒$dialstatus,
- «mp3link» ⇒ $mp3Link,
- «billsec»⇒$billsec,
- «eventType»⇒'2',
- «serverTime»⇒$serverTime
При завершении звонка передаются следующие параметры:
- «linkedid» ⇒ $linkedid,
- «duration»⇒$billsec,
- «dialstatus»⇒$dialstatus,
- «mp3link» ⇒ $mp3link,
- «key»⇒$key,
- «billsec»⇒$billsec,
- «eventType»⇒$eventType,
- «serverTime»⇒$serverTime.
Все эти данные система ВАТС отправляет POST-запросами. $crmUserId может иметь значение мобильного номера, если на экстене настроена переадресация на мобильный номер. Ссылку на файл - mp3link, система присылает путём GET-запроса в процессе вызова, например:
https://[ip_адрес_сервера]/getVrl.php?id=3bfq2df36ER78&key=sk24r9sdRTjie57SVDtyiuer&filename=1346745455.435.mp3
Прием запросов от crm системы на соединение с внутренним номером для осуществление вызова напрямую из карточки контакта crm, например:
http(s)://[ip адрес сервера]/makeCall.php?clientId=3bfq2df36ER78&code=101&phone=79991231313
- clientId - это ключ который мы генерируем на своей стороне и передаем Вам
- code - внутренний номер абонента
- phone - вызываемый номер
- [ip-адрес_сервера] - это виртуальная атс