Entwicklerzentrum

Machen Sie Ihre Telefonanlage zum Teil Ihrer Software.

Ein API-Schlüssel, reines HTTP, JSON-Antworten. Von Click-to-call und Anrufsteuerung über Auto-Call-Kampagnen und Aufgaben des Sprachassistenten bis zum Sprach-Bestätigungscode ist alles REST; die Ergebnisse kommen über HMAC-signierte Webhooks zurück.

Schnellstart

Ihre erste Anfrage in 2 Minuten

Holen Sie sich Ihren Schlüssel unter Panel > Auto-Call > Reiter API (oder in den Telefonanlagen-Einstellungen); senden Sie ihn per Bearer-Header, X-Api-Key oder ?key=.

  • Der Schlüssel ist an Ihr Kundenkonto gebunden; auf Daten anderer Kunden kann er nicht zugreifen.
  • Lesevorgänge per GET, ändernde Vorgänge per POST; Body als JSON oder Formular.
  • Die Fehlerantwort enthält immer {"ok":false,"error":"…","code":"…"} hat das Format.
  • Ratenbegrenzung: 120 Anfragen pro Minute und Schlüssel; bei Überschreitung 429.
# Click-to-call: Nebenstelle 1001 klingelt zuerst, nach Annahme wird das Ziel angerufen curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # Kampagne erstellen 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"}}' # Sprach-Bestätigungscode senden 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}
Webhooks

Die Ergebnisse sollen zu Ihnen kommen, Sie sollen nicht nachfragen.

Auto-Call-Ergebnis, Zusammenfassung des Assistentengesprächs, Status des Bestätigungscodes — jedes Ereignis wird als JSON per POST an Ihre Adresse gesendet; der Header X-Buluthat-Signature ist die HMAC-SHA256-Signatur. Fehlgeschlagene Zustellungen werden nach 1 Min. → 6 Std. erneut versucht.

Webhook-Dokumentation
// PHP: Signaturprüfung $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-Brücke

Der Sprachassistent findet im CRM Kunden, legt Serviceeinträge an, hinterlässt Notizen; aus dem CRM wird „mit dem Assistenten anrufen“ gestartet. Fertig, ein einziger Schlüssel.

Details
PHP-Client

Fertige PHP-Klasse für den Sprach-Bestätigungscode; mit zwei Zeilen senden/verifizieren. Die übrigen Endpunkte sind reines HTTP und lassen sich aus jeder Sprache aufrufen.

Beispiel
Einbettbarer Live-Bildschirm

Live-Transkript des Assistentengesprächs als iframe im CRM; mit zeitlich begrenztem signiertem Token, keine Panel-Sitzung nötig.

embed_url