Запуск вызова (click-to-call)Завершить вызов Перевести вызов Отключить / включить микрофон Данные живых вызовов Типичный сценарий: click-to-call из CRM

Управление вызовами

Запускайте вызовы из своего ПО (click-to-call), завершайте, переводите или отключайте микрофон текущего вызова. Все методы — ключ API (область call; Authorization: Bearer bt_… в заголовке, см. Безопасность API) и GET вызывается методом.

Лимит запросов: 10 в минуту. Идентификатор вызова (call_uuid) begin_call возвращается в ответе и в данных живого вызова.

GETЗапуск вызова (click-to-call)

Сначала звонит указанный внутренний номер; когда он отвечает, набирается целевой номер, и стороны соединяются.

GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567

Параметр	Обязательно	Описание
`Authorization` (заголовок)	да	`Bearer bt_…`, область `call`
`extension`	да	Внутренний номер, на который будет соединён вызов (напр. `1001`)
`destination`	да	Номер для вызова. Для Турции `905321234567`, для звонков за границу `00` + код страны
`caller_id`	нет	Номер, отображаемый при внешнем звонке; если не указан, используется номер внутреннего по умолчанию. Номер, не принадлежащий вашему аккаунту `400` возвращается
`manual_answer`	нет	`true` то ожидается ручное открытие внутренним номером; если не задан, на поддерживающих устройствах ответ даётся автоматически
`timeout`	нет	Длительность звонка, 10–60 с (по умолчанию 30)
`announcement_to_caller`	нет	ID аудиообъявления, которое воспроизводится внутреннему номеру в момент соединения
`announcement_to_callee`	нет	ID аудиообъявления, которое воспроизводится вызываемому в момент соединения

Успешный ответ: 200 OK, в теле — идентификатор вызова.

358c20bc-fd86-11e5-87a2-157d41a07454

Примеры ошибочных ответов:

400 Bad Request   extension 1005 not found
400 Bad Request   caller_id 02120000000 not allowed
401 Unauthorized  Geçersiz anahtar: K…

GETЗавершить вызов

GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>

id вместо также принимается формат пути: /api/hangup/<call_uuid>. Ответ 200 OK.

GETПеревести вызов

Переводит текущий вызов на внутренний или внешний номер.

GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002

Параметр	Описание
`id`	Идентификатор вызова
`user_number`	Внутренний номер-получатель (напр. `1002`) или внешний номер (`905321234567`)

GETОтключить / включить микрофон

GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=on

state: on (отключить микрофон) или off (включить звук).

Данные живых вызовов

Список текущих вызовов (звонящий, вызываемый, внутренний номер, статус, длительность) читается через метод моста CRM; для открытия карточки клиента при входящем звонке используйте эти данные или webhook. Подробности — запросите документ «Мост CRM» в Центре поддержки; для Byfix CRM мост уже готов.

Типичный сценарий: click-to-call из CRM

1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir

← Безопасность API Очереди