Gespreksbeheer
Start oproepen vanuit uw software (click-to-call), beëindig, verbind door of demp een lopende oproep. Alle endpoints met API-sleutel (bereik call; Authorization: Bearer bt_… in de header, zie API-beveiliging) met en GET wordt aangeroepen met de methode.
Snelheidslimiet: 10 verzoeken per minuut. De oproep-ID (call_uuid)begin_callwordt teruggegeven in het antwoord en in de live oproepgegevens.
GETOproep starten (click-to-call)
Het opgegeven toestel gaat eerst over; zodra het wordt opgenomen, wordt het doelnummer gebeld en worden beide partijen verbonden.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parameter | Verplicht | Omschrijving |
|---|---|---|
Authorization (kop) | ja | Bearer bt_…, bereik call |
extension | ja | Toestel waarmee de oproep wordt verbonden (bijv. 1001) |
destination | ja | Te bellen nummer. Voor Turkije 905321234567, voor het buitenland 00 + landcode |
caller_id | nee | Nummer dat bij uitgaande oproepen wordt getoond; indien niet opgegeven, de standaard van het toestel. Een nummer dat niet bij uw account hoort 400 geeft terug |
manual_answer | nee | true moet het toestel handmatig opnemen; indien niet opgegeven wordt op ondersteunde apparaten automatisch opgenomen |
timeout | nee | Beltijd, 10-60 sec (standaard 30) |
announcement_to_caller | nee | ID van de aankondiging die bij verbinding aan het toestel wordt afgespeeld |
announcement_to_callee | nee | ID van de aankondiging die bij verbinding aan de gebelde wordt afgespeeld |
Geslaagd antwoord: 200 OK, in de body de oproep-ID.
358c20bc-fd86-11e5-87a2-157d41a07454Voorbeelden van foutieve antwoorden:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETOproep beëindigen
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id in plaats van wordt ook de padnotatie geaccepteerd: /api/hangup/<call_uuid>. Antwoord 200 OK.
GETOproep doorverbinden
Verbindt een lopende oproep door naar een toestel of extern nummer.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parameter | Omschrijving |
|---|---|
id | Oproep-ID |
user_number | Doeltoestel (bijv. 1002) of een extern nummer (905321234567) |
GETDempen / dempen opheffen
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (dempen) of off (geluid aan).
Live oproepgegevens
De lijst met lopende oproepen (beller, gebelde, toestel, status, duur) wordt uit het endpoint van de CRM-brug gelezen; gebruik deze gegevens of webhooks om bij een inkomende oproep de klantkaart te openen. Vraag voor details bij het Helpcentrum de documentatie "CRM-brug" aan; voor het Byfix CRM is de brug klaar.
Typische flow: click-to-call vanuit het 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