Звонки через API

Звонок программы — такой же звонок линии, как у оператора: он попадает в журнал звонков, в историю диалога и в CRM. Программа видит только линии своего ключа и только те диалоги, которые видит оператор.

Звонки через API работают на линиях WhatsApp Web и Telegram.

Что умеет программа

• Принять входящий звонок, отклонить его или положить трубку.
• Позвонить клиенту с линии: звонок принадлежит программе с первого гудка.
• Говорить и слушать клиента в реальном времени и замолкать, когда он перебивает.
• Передать клиента людям линии: клиент слышит гудки, у операторов звонит, как обычный входящий.
• Выбрать, кому из сотрудников звонок позвонит первым.
• Узнавать о звонках из событий — на свой вебхук или опросом, даже без своего сервера.
• Искать в истории звонки по тому, что было в разговоре, и узнавать повторные звонки клиента.
• Получать итог звонка — разговор в числах, посчитанный по звуку записи, без ИИ.

Шаг 1. Получите ключ для звонков

1. Владелец или администратор открывает Настройки → API.
2. Нажмите Ключ для звонков.
3. Отметьте линии, на которых будет работать программа.
4. Скопируйте ключ gw_…: он показывается один раз. Отозвать ключ можно там же.
5. Выполните команду проверки рядом с ключом: она покажет звонки, которые сейчас идут на его линиях.

Вы увидите: команда проверки вернёт звонки, которые сейчас идут на линиях ключа.

У ключа для звонков два права: calls:voice — брать и делать звонки, говорить в них, и channels:read — видеть линии.

Шаг 2. Первый запрос

Адрес API — https://dialogs.tehprof.kz/api/v1/gw/. В каждом запросе — заголовок Authorization: Bearer gw_….

curl https://dialogs.tehprof.kz/api/v1/gw/calls/ \
  -H "Authorization: Bearer gw_xxx"

{ "calls": [] }

Вы увидите: ответ { "calls": [] }, если звонков сейчас нет, или список идущих звонков.

Дальше: первый бот

• Быстрее всего — SDK на Python: бот, который отвечает и передаёт клиента людям, занимает десяток строк.
• Свой код на любом языке — команды, голос и события.
• Разбор звонков после разговора — история и итог звонка.
• Если запрос отказал — ошибки.