Керування дзвінками
Ініціюйте дзвінок зі свого ПЗ (клік-дзвінок), завершуйте поточний дзвінок, переадресовуйте або вимикайте звук. Усі кінцеві точки — API-ключ (область call; Authorization: Bearer bt_… у заголовку, див. Безпека API) з та GET викликається методом.
Ліміт швидкості: 10 запитів на хвилину. Ідентифікатор дзвінка (call_uuid)begin_callповертається у відповіді та в живих даних про дзвінки.
GETІніціювання дзвінка (клік-дзвінок)
Спочатку дзвонить вказаний внутрішній номер; коли він відповідає, набирається цільовий номер і обидві сторони з'єднуються.
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=onstate: on (вимкнути звук) або off (увімкнути звук).
Жива інформація про дзвінки
Список поточних дзвінків (абонент, номер виклику, внутрішній номер, статус, тривалість) зчитується з кінцевої точки моста CRM; для відкриття картки клієнта при вхідному дзвінку використовуйте ці дані або webhook. За деталями запросіть у Центрі підтримки документ «Міст CRM»; для Byfix CRM міст готовий.
Типовий потік: клік-дзвінок із 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