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

Работа с обзвонами

API позволяет создавать исходящие обзвоны, получать их статус и список номеров, смотреть обзвоны в работе и завершённые, отменять обзвон.

Для новых интеграций используйте методы v2.
Base URL: https://dialog-api.intersvyaz.it

Во всех методах (кроме login): HTTP Authorization Scheme: bearer

Рекомендуемый порядок вызовов

  1. Получить токен: POST /v1/auth/login.
  2. Получить проекты: GET /v1/project/get_user_projects.
  3. Получить start_block_id и phone_id: GET /v1/project/{project_id}/info.
  4. Создать обзвон: POST /v2/calls.
    Результаты диалогов - раздел "Аналитика диалогов" (в фильтре отчёта передайте UUID обзвона в call_id).

Важные особенности

  • ID обзвона в v2 - UUID (в v1 - целое число)
  • project_id, start_block_id, phone_id должны относиться к одному проекту
  • start_date / end_date интерпретируются в часовом поясе проекта. Если start_date не передан - подставится текущие дата и время
  • В params передаются переменные стартового блока: {ключ: значение}
  • Для доп. данных номера в v2 поле называется params (в v1 было add_data).
  • После звонка появиться dialog_uuid - его можно передать в Получение информации о конкретном диалоге. v1.
Наверх