Geliştirici Merkezi

Santralinizi yazılımınızın parçası yapın.

Tek API anahtarı, düz HTTP, JSON cevaplar. Tıkla-ara ve çağrı kontrolünden otomatik arama kampanyalarına, sesli asistan görevlerinden sesli doğrulama koduna kadar her şey REST; sonuçlar HMAC imzalı webhook'larla geri gelir.

Hızlı başlangıç

İlk isteğiniz 2 dakikada

Panel > Otomatik Arama > API sekmesinden (ya da Santral Ayarları'ndan) anahtarınızı alın; Bearer başlığı, X-Api-Key ya da ?key= ile gönderin.

Anahtar müşteri hesabınıza bağlıdır; başka müşterinin verisine erişemez.
Okuma işlemleri GET, değiştiren işlemler POST; gövde JSON ya da form.
Hata cevabı her zaman {"ok":false,"error":"…","code":"…"} biçimindedir.
Hız sınırı: anahtar başına dakikada 120 istek; aşımda 429.

Genel bakışı oku Başvuru yap

# tıkla-ara: dahili 1001 önce çalar, açınca hedef aranır curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # kampanya oluştur 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"}}' # sesli doğrulama kodu gönder 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}

Dokümantasyon

API başlıkları

Her başlıkta uç adresi, parametreler, örnek istek ve cevap.

Genel Bakış

Kimlik doğrulama, istek biçimi, hata kodları, hız sınırları

Oku

API Güvenliği

Anahtar ve kapsamlar, izinli IP, HMAC istek imzalama, anahtar yenileme, istek günlüğü

Oku

Çağrı Yönetimi

Tıkla-ara, sonlandır, aktar, sessize al

Oku

Kuyruklar

Kuyruk listesi, bekleyenler, üye ekle/çıkar

Oku

Temsilci Durumları

Dahili durumları ve kuyruk üyelikleri

Oku

Karaliste

Engelli numaraları listele, ekle, sil

Oku

Ses Dosyaları

Anons listesi, yükleme, güncelleme, silme

Oku

Otomatik Arama

Kampanya kur, numara ekle, sonuç al, webhook

Oku

Sesli Asistan

Görüşmeler, notlar, randevular, görev araması, gömme

Oku

Sesli Doğrulama (OTP)

Kod gönder, doğrula, durum, webhook

Oku

SMS API

Toplu / kişiye özel SMS, OTP SMS, teslim raporu, gelen SMS, kara liste

Oku

Webhook'lar

İmza doğrulama, tekrar politikası, olay şemaları

Oku

Gömme (CRM iframe)

Santral ekranları ve web telefonu yazılımınızda: kod, imzalı link, JavaScript olayları

Oku

Webhook'lar

Sonuçlar size gelsin, siz sormayın.

Otomatik arama sonucu, sesli asistan görüşme özeti, doğrulama kodu durumu — her olay JSON olarak adresinize POST edilir; X-Buluthat-Signature başlığı HMAC-SHA256 imzasıdır. Başarısız teslimat 1 dk → 6 saat aralıklarla tekrar denenir.

Webhook dokümanı

// 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öprüsü

Sesli asistan CRM'de müşteri bulur, servis kaydı açar, not düşer; CRM'den "asistanla ara" başlatılır. Hazır, tek anahtar.

Ayrıntı

PHP istemci

Sesli doğrulama kodu için hazır PHP sınıfı; iki satırla gönder/doğrula. Diğer uçlar düz HTTP olduğundan her dilden çağrılır.

Örnek

Gömülebilir canlı ekran

Asistan görüşmesinin canlı dökümü CRM içinde iframe; süreli imzalı token ile, panel oturumu gerekmez.

embed_url