Calls API
Платформа JAICP предоставляет Calls API для работы с исходящей телефонией.
Перед началом работы с Calls API необходимо:
Методы API
API предоставляет методы для следующих операций:
-
Добавление телефонных номеров с параметрами в обзвон.
POST /api/calls/campaign/{token}/addPhones
GET /api/crmCalls/campaign/{token}/addPhone
POST /api/crmCalls/campaign/{token}/addPhone
GET /api/crmCalls/campaign/{token}/test/addPhone
-
Отмена созданных заданий на обзвон.
POST /api/calls/campaign/{token}/callJob/cancel
-
Получение отчетов по ID задания на обзвон или по номеру телефона.
POST /api/calls/campaign/{token}/callJob/getReport
POST /api/calls/campaign/{token}/callAttempt/getReport
-
Получение информации об обзвоне.
GET /api/calls/campaign/{token}
GET /api/calls/campaign/{token}/status
-
Приостановление, возобновление и остановка обзвона.
POST /api/calls/campaign/{token}/control/pause
POST /api/calls/campaign/{token}/control/resume
POST /api/calls/campaign/{token}/control/stop
Параметры запросов
Обязательные параметры
В строки запросов к Calls API подставляются следующие обязательные параметры:
host_name
— имя хоста, на котором запущен обзвон.token
— уникальный токен для управления обзвоном.
Например, для https://app.jaicp.com/
строка запроса на добавление телефонных номеров может выглядеть следующим образом:
https://app.jaicp.com/api/calls/campaign/8231.7056.1b131df1/addPhones
Ключ идемпотентности
Чтобы контролировать сог ласованность создаваемых ресурсов, клиентские приложения могут генерировать и передавать в Calls API ключ идемпотентности.
Если же для таких запросов ключ идемпотентности не передан или отличается между запросами, запросы считаются разными, и одинаковый результат их выполнения не гарантируется.