Zəng İdarəetməsi
Proqramınızdan zəng başladın (kliklə-zəng), davam edən zəngi bitirin, yönləndirin ya da səssizə alın. Bütün nöqtələr API açarı (əhatə call; Authorization: Bearer bt_… başlığında, bax API Təhlükəsizliyi) ilə və GET metodu ilə çağırılır.
Sürət limiti: dəqiqədə 10 sorğu. Zəng identifikatoru (call_uuid)begin_callcavabında və canlı zəng məlumatında qayıdır.
GETZəng başlatma (kliklə-zəng)
Əvvəlcə göstərilən daxili çalır; daxili açanda hədəf nömrəyə zəng edilir və iki tərəf qoşulur.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parametr | Məcburi | İzah |
|---|---|---|
Authorization (başlıq) | bəli | Bearer bt_…, əhatə call |
extension | bəli | Zəngin qoşulacağı daxili (məs. 1001) |
destination | bəli | Zəng ediləcək nömrə. Türkiyə üçün 905321234567, xaricə zəng üçün 00 + ölkə kodu |
caller_id | xeyr | Xarici zəngdə görünəcək nömrə; verilməzsə daxilinin defoltu. Hesabınıza aid olmayan nömrə 400 qaytarır |
manual_answer | xeyr | true isə daxilinin əl ilə açması gözlənilir; verilməzsə dəstəkləyən cihazlarda avtomatik cavablandırılır |
timeout | xeyr | Çaldırma müddəti, 10-60 san (defolt 30) |
announcement_to_caller | xeyr | Qoşulma anında daxiliyə çalınacaq anons ID-si |
announcement_to_callee | xeyr | Qoşulma anında zəng edilənə çalınacaq anons ID-si |
Uğurlu cavab: 200 OK, gövdədə zəng identifikatoru.
358c20bc-fd86-11e5-87a2-157d41a07454Yanlış cavab nümunələri:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETZəngi bitir
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id əvəzinə yol formatı da qəbul edilir: /api/hangup/<call_uuid>. Cavab 200 OK.
GETZəngi yönləndir
Davam edən zəngi bir daxiliyə ya da xarici nömrəyə yönləndirir.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parametr | İzah |
|---|---|
id | Zəng identifikatoru |
user_number | Hədəf daxili (məs. 1002) və ya xarici nömrə (905321234567) |
GETSəssizə al / səsli et
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (səssizə al) və ya off (səsi aç).
Canlı zəng məlumatı
Davam edən zənglərin siyahısı (zəng edən, zəng edilən, daxili, vəziyyət, müddət) CRM körpüsü nöqtəsindən oxunur; daxil olan zəngdə müştəri kartı açmaq üçün bu məlumatı ya da webhook-ları istifadə edin. Ətraflı üçün Dəstək Mərkəzindən "CRM körpüsü" sənədini istəyin; Byfix CRM üçün körpü hazırdır.
Tipik axın: CRM-dən kliklə-zəng
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