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.
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.
API-Header
Unter jeder Überschrift Endpunktadresse, Parameter, Beispielanfrage und -antwort.
Überblick
Authentifizierung, Anfrageformat, Fehlercodes, Ratenbegrenzungen
LesenAPI-Sicherheit
Schlüssel und Geltungsbereiche, zugelassene IPs, HMAC-Anfragesignatur, Schlüsselerneuerung, Anfrageprotokoll
LesenAnrufverwaltung
Click-to-call, beenden, weiterleiten, stummschalten
LesenWarteschlangen
Warteschlangenliste, Wartende, Mitglieder hinzufügen/entfernen
LesenAgentenstatus
Nebenstellenstatus und Warteschlangenmitgliedschaften
LesenSperrliste
Gesperrte Nummern auflisten, hinzufügen, löschen
LesenAudiodateien
Ansagenliste, Hochladen, Aktualisieren, Löschen
LesenAuto-Call
Kampagne einrichten, Nummern hinzufügen, Ergebnisse abrufen, Webhook
LesenSprachassistent
Gespräche, Notizen, Termine, Aufgabenanruf, Einbettung
LesenSprach-Verifizierung (OTP)
Code senden, verifizieren, Status, Webhook
LesenSMS-API
Massen- / personalisierte SMS, OTP-SMS, Zustellbericht, eingehende SMS, Sperrliste
LesenWebhooks
Signaturprüfung, Wiederholungsrichtlinie, Ereignisschemata
LesenEinbetten (CRM iframe)
In Ihrer Telefonanlage und WebPhone-Software: Code, signierter Link, JavaScript-Ereignisse
LesenDie 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.
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.
DetailsPHP-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.
BeispielEinbettbarer Live-Bildschirm
Live-Transkript des Assistentengesprächs als iframe im CRM; mit zeitlich begrenztem signiertem Token, keine Panel-Sitzung nötig.
embed_url