Anrufverwaltung
Starten Sie Anrufe aus Ihrer Software (Click-to-call), beenden, übergeben oder stummschalten Sie laufende Anrufe. Alle Endpunkte API-Schlüssel (Geltungsbereich call; Authorization: Bearer bt_… im Header, siehe API-Sicherheit) und GET wird mit der Methode aufgerufen.
Ratenbegrenzung: 10 Anfragen pro Minute. Anruf-ID (call_uuid)begin_callkommt in der Antwort und in den Live-Anrufdaten zurück.
GETAnruf starten (Click-to-call)
Zuerst klingelt die angegebene Nebenstelle; nimmt sie an, wird die Zielnummer angerufen und beide Seiten werden verbunden.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parameter | Pflichtfeld | Beschreibung |
|---|---|---|
Authorization (Absenderkennung) | ja | Bearer bt_…, Geltungsbereich call |
extension | ja | Nebenstelle, mit der der Anruf verbunden wird (z. B. 1001) |
destination | ja | Anzurufende Nummer. Für die Türkei 905321234567, für das Ausland 00 + Ländervorwahl |
caller_id | nein | Nummer, die bei Außenanrufen angezeigt wird; wenn nicht angegeben, der Standard der Nebenstelle. Eine Nummer, die nicht zu Ihrem Konto gehört 400 kommt zurück |
manual_answer | nein | true wird erwartet, dass die Nebenstelle manuell annimmt; wenn nicht angegeben, wird bei unterstützenden Geräten automatisch angenommen |
timeout | nein | Klingeldauer, 10-60 Sek. (Standard 30) |
announcement_to_caller | nein | ID der Ansage, die der Nebenstelle bei Verbindungsaufbau abgespielt wird |
announcement_to_callee | nein | ID der Ansage, die dem Angerufenen bei Verbindungsaufbau abgespielt wird |
Erfolgreiche Antwort: 200 OK, im Body die Anruf-ID.
358c20bc-fd86-11e5-87a2-157d41a07454Beispiele für fehlerhafte Antworten:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETAnruf beenden
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id statt dessen wird auch das Pfadformat akzeptiert: /api/hangup/<call_uuid>. Antwort 200 OK.
GETAnruf weiterleiten
Leitet einen laufenden Anruf an eine Nebenstelle oder externe Nummer weiter.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parameter | Beschreibung |
|---|---|
id | Anruf-ID |
user_number | Ziel-Nebenstelle (z. B. 1002) oder externe Nummer (905321234567) |
GETStumm / Ton ein
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (stummschalten) oder off (Ton einschalten).
Live-Anrufdaten
Die Liste laufender Anrufe (Anrufer, Angerufener, Nebenstelle, Status, Dauer) wird über den CRM-Brücken-Endpunkt gelesen; nutzen Sie diese Daten oder Webhooks, um bei einem eingehenden Anruf die Kundenkarte zu öffnen. Fordern Sie für Einzelheiten im Support-Center die Dokumentation „CRM-Brücke“ an; für das Byfix-CRM ist die Brücke fertig.
Typischer Ablauf: Click-to-call aus dem CRM
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