Перейти к основному содержимому

Отчеты по обзвонам

Следующие методы Calls API позволяют получить отчет в формате JSON:

  • POST https://app.aimylogic.com/api/calls/campaign/{token}/callJob/getReport — отчет по номерам.
  • POST https://app.aimylogic.com/api/calls/campaign/{token}/callAttempt/getReport — отчет по попыткам.

Тело запроса

В теле запроса к данному методу передается JSON с любым из следующих полей:

  • phones — массив номеров, по которым нужно получить отчет.
  • ids — идентификаторы заданий на обзвон, по которым требуется отчет.
подсказка
Вы также можете передать оба поля одновременно.

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

curl --request POST 'https://app.aimylogic.com/api/calls/campaign/8231.7056.1b131df1/callJob/getReport' \
--header 'Content-Type: application/json' \
--data-raw '{
"phones": [
79123456789
],
"ids": [
12345,
67890
]
}'

Содержимое отчета

Ответ на запрос — массив объектов с полями, содержащими информацию по заданиям на обзвон или попыткам их выполнить. Приведем некоторые из них:

  • startedAt и finishedAt — Unix-время начала и окончания звонка в миллисекундах.
  • callDuration — продолжительность звонка в секундах.
  • callResult — результат, достигнутый в ходе звонка.
  • reportData — произвольные данные, зафиксированные в сценарии.
  • jobStatus — статус задания на обзвон в момент формирования отчета.

Статусы заданий на обзвон

Значение поляОписание
canceledЗвонок был отменен.
inProcessЗвонок в процессе.
longCallWithNoResultЗвонок завершен без результата.
longCallWithResultЗвонок завершен с результатом.
noAnswerВсе попытки дозвониться закончились без ответа абонента.
nonexistentNumberЗвонок был совершен на несуществующий номер.
notDoneЗвонок не был совершен, но обзвон завершен.
onRetryИдет повторная попытка дозвониться.
plannedЗвонок находится в очереди: например, ждет доступных линий.