Developer Mərkəzi

Santralınızı proqramınızın hissəsinə çevirin.

Tək API açarı, düz HTTP, JSON cavablar. Kliklə-zəng və zəng idarəetməsindən avtomatik zəng kampaniyalarına, səsli asistent tapşırıqlarından səsli doğrulama koduna qədər hər şey REST; nəticələr HMAC imzalı webhook-larla geri gəlir.

Sürətli başlanğıc

İlk sorğunuz 2 dəqiqəyə

Panel > Avtomatik Zəng > API tabından (ya da Santral Ayarlarından) açarınızı alın; Bearer başlığı, X-Api-Key ya da ?key= ilə göndərin.

Açar müştəri hesabınıza bağlıdır; başqa müştərinin məlumatına çıxış əldə edə bilməz.
Oxuma əməliyyatları GET, dəyişdirən əməliyyatlar POST; gövdə JSON ya da form.
Xəta cavabı həmişə {"ok":false,"error":"…","code":"…"} formatındadır.
Sürət limiti: açar başına dəqiqədə 120 sorğu; aşımda 429.

Ümumi baxışı oxu Müraciət et

# kliklə-zəng: daxili 1001 əvvəlcə çalır, açılanda hədəfə zəng edilir curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # kampaniya yarat curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Ödeme hatırlatma","campaign_type":"ivr", "tts_template":"Merhaba {sayin}, {tutar} tutarındaki ödemeniz…", "digit_labels":{"1":"Ödedim","2":"Yetkili"}}' # səsli doğrulama kodu göndər curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}

Sənədləşmə

API başlıqları

Hər başlıqda son nöqtə ünvanı, parametrlər, nümunə sorğu və cavab.

Ümumi Baxış

Kimlik doğrulama, sorğu formatı, xəta kodları, sürət limitləri

Oxu

API Təhlükəsizliyi

Açar və əhatələr, icazəli IP, HMAC sorğu imzalama, açar yeniləmə, sorğu jurnalı

Oxu

Zəng İdarəetməsi

Kliklə-zəng, bitir, yönləndir, səssizə al

Oxu

Növbələr

Növbə siyahısı, gözləyənlər, üzv əlavə et/çıxar

Oxu

Nümayəndə Vəziyyətləri

Daxili vəziyyətlər və növbə üzvlükləri

Oxu

Qara siyahı

Əngəllənmiş nömrələri siyahıla, əlavə et, sil

Oxu

Səs Faylları

Anons siyahısı, yükləmə, yeniləmə, silmə

Oxu

Avtomatik Zəng

Kampaniya qur, nömrə əlavə et, nəticə al, webhook

Oxu

Səsli Asistent

Söhbətlər, qeydlər, görüşlər, tapşırıq zəngi, yerləşdirmə

Oxu

Səsli Doğrulama (OTP)

Kod göndər, doğrula, vəziyyət, webhook

Oxu

SMS API

Toplu / şəxsi SMS, OTP SMS, çatdırılma hesabatı, daxil olan SMS, qara siyahı

Oxu

Webhook-lar

İmza doğrulama, təkrar siyasəti, hadisə sxemləri

Oxu

Gömülmə (CRM iframe)

Santral ekranları və web telefonu proqramınızda: kod, imzalı link, JavaScript hadisələri

Oxu

Webhook-lar

Nəticələr sizə gəlsin, siz soruşmayın.

Avtomatik zəng nəticəsi, səsli asistent söhbət xülasəsi, doğrulama kodu vəziyyəti — hər hadisə JSON olaraq ünvanınıza POST edilir; X-Buluthat-Signature başlığı HMAC-SHA256 imzasıdır. Uğursuz çatdırılma 1 dəq → 6 saat aralıqlarla yenidən sınanır.

Webhook sənədi

// PHP: imza doğrulama $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …

Byfix CRM körpüsü

Səsli asistent CRM-də müştəri tapır, servis qeydi açır, qeyd düşür; CRM-dən "asistentlə zəng et" başladılır. Hazır, tək açar.

Ətraflı

PHP klienti

Səsli doğrulama kodu üçün hazır PHP sinfi; iki sətirlə göndər/doğrula. Digər nöqtələr düz HTTP olduğundan hər dildən çağırılır.

Nümunə

Yerləşdirilə bilən canlı ekran

Asistent söhbətinin canlı mətni CRM daxilində iframe; müddətli imzalı token ilə, panel sessiyası lazım deyil.

embed_url