Отчеты по обзвону
Следующие методы Calls API позволяют получить отчёт в формате JSON:
POST /api/calls/campaign/{token}/callJob/getReport— отчет по номерам.POST /api/calls/campaign/{token}/callAttempt/getReport— отчет по попыткам.
Тело запроса
В теле запроса к данному методу передается JSON с любым из следующих полей:
phones— массив номеров, по которым нужно получить отчет.ids— идентификаторы заданий на обзвон, по которым требуется отчет.
подсказка
Вы также можете передать оба поля одновременно.
Пример запроса
curl --request POST 'https://app.jaicp.com/api/calls/campaign/8231.7056.1b131df1/callJob/getReport' \
--header 'Content-Type: application/json' \
--data-raw '{
"phones": [
79110000000
],
"ids": [
12345,
67890
]
}'
Содержимое отчета
Ответ на запрос — массив объектов с полями, содержащими информацию по заданиям на обзвон или попыткам их выполнить. Приведем некоторые из них:
startedAtиfinishedAt— Unix-время начала и окончания звонка в миллисекундах.callDuration— продолжительность звонка в секундах.callResult— результат звонка.reportData— данные, зафиксированные в сценарии методом$dialer.reportData.jobStatus— статус задания на обзвон в момент формирования отчета.
Статусы заданий на обзвон
| Значение поля | Описание |
|---|---|
canceled | Звонок был отменен. |
inProcess | Звонок в процессе. |
longCallWithNoResult | Звонок завершен без результата. |
longCallWithResult | Звонок завершен с результатом. |
noAnswer | Все попытки дозвониться закончились без ответа абонента. |
nonexistentNumber | Звонок был совершен на несуществующий номер. |
notDone | Звонок не был совершен, но обзвон завершен. |
onRetry | Идет повторная попытка дозвониться. |
planned | Звонок находится в очереди: например, ждет доступных линий. |