Данный метод позволяет добавлять звонки в интерфейс К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, указанная в ссылке на сайт |