Данный метод позволяет добавлять звонки в интерфейс К50:Трекер
Добавление звонков
Адрес для отправки запроса
https://api.tracker.k50.ru/v2/call/add/
Поддерживаемые методы: GET, POST
Для POST запросов, параметры в GET не учитываются (кроме параметра apiKey).
Пример запроса
GET
https://api.tracker.k50.ru/v2/call/add/?apiKey=0000-0000-0000-0000&counter=0000000&callId=11sb3y55-111269h10947jfvrs&startTime=2018-10-23%2019:04:11&callerPhone=70000000000&calledPhone=71111111111&duration=5&poolName=TestPool&connectDuration=5&isCallback=true&tags=tag1&status=success
POST
https://api.tracker.k50.ru/v2/call/add/
{ "apiKey":"0000-0000-0000-0000", "counter":"0000000000", "callId":"zeeeer123146", "startTime":"2018-10-24 12:00:23", "stopTime":"2018-10-24 12:05:54", "callerPhone":"71234567890", "calledPhone":"70987654321" }
Формат ответа
Формат ответа в случае корректного запроса
{"result": true}
Формат ответа в случае ошибочного запроса:
{"error":<HTTP_RESPONSE_CODE>,"message":"<MESSAGE>"}
Пример:
{"error":400,"message":"callId is required"}
Параметры запроса
Жирным отмечены обязательные поля
Параметр | Описание |
---|---|
apiKey | Авторизационный токен токен доступа к API. Более подробная информация содержится здесь |
counter | ID счетчика |
callId | Id звонка |
startTime | Время начала звонка. Указывается в любом часовом поясе. |
callerPhone | Номер телефона клиента. |
calledPhone | Номер назначения |
stopTime | Время окончания звонка. Если не указано, то считается равной startTime. Указывается в любом часовом поясе. |
duration | Длительность звонка в секундах. Если не указана, то длительность вычисляется на основе параметров startTime и stopTime |
poolName | Название пула |
connectDuration | Время ожидания вызова в секундах. Если не задано, то в интерфейсе будет =0 |
isCallback | Направление звонка. false=прямой, true=обратный |
callRecordUrl | URL адрес записи звонка |
tags | Теги |
destination | Номер переадресации |
status | Статус звонка. Значение успешного-success, значение неудачного-failed. По умолчанию success |
dtmfIn | Нажатие dtmf-клавиши менеджером КЦ |
dtmfOut | Нажатие dtmf-клавиши клиентом |
isFisrtInSeries | true=уникальный, false=повторный. |
compostieSource | Источник посещения |
compsoiteSourceType | Тип трафика |
compositeKeyword | Ключевое слово |
entryPoint | Страница входа |
referral | Реферер |
utmSource | Метка utm_source, указанная в ссылке на сайт. |
utmMedium | Метка utm_medium, указанная в ссылке на сайт. |
utmCampaign | Метка utm_campaign, указанная в ссылке на сайт. |
utmContent | Метка utm_content, указанная в ссылке на сайт. |
utmTerm | Метка utm_term, указанная в ссылке на сайт. |
analyticsClientId | Идентификатор пользователя (UserID) в Google Analytics. |
metrikaClientId | Идентификатор пользователя (UserID) в Яндекс.Метрике. |
userAgent | User Agent пользователя |
IP | IP-адрес пользователя |
customDimension1 | Пользовательское измерение 1 |
customDimension2 | Пользовательское измерение 2 |
customDimension3 | Пользовательское измерение 3 |
customDimension4 | Пользовательское измерение 4 |
customDimension5 | Пользовательское измерение 5 |
callPage | URL страницы, на которой находился пользователь в момент звонка. |
yClid | Метка yclid, указанная в ссылке на сайт |
gClid | Метка gclid, указанная в ссылке на сайт |