Ontwikkelaarscentrum

Maak uw telefooncentrale onderdeel van uw software.

Eén API-sleutel, gewone HTTP, JSON-antwoorden. Van click-to-call en gespreksbesturing tot campagnes voor automatisch bellen, van taken voor de spraakassistent tot spraakverificatiecodes: alles is REST; resultaten komen terug via webhooks met HMAC-handtekening.

Snelstart

Uw eerste verzoek in 2 minuten

Haal uw sleutel op via Paneel > Automatisch bellen > tabblad API (of via Telefooncentrale-instellingen); verstuur hem met een Bearer-header, X-Api-Key of ?key=.

De sleutel is gekoppeld aan uw klantaccount; toegang tot gegevens van andere klanten is niet mogelijk.
Leesbewerkingen zijn GET, wijzigende bewerkingen POST; body JSON of formulier.
Het foutantwoord is altijd {"ok":false,"error":"…","code":"…"} heeft het formaat.
Snelheidslimiet: 120 verzoeken per minuut per sleutel; bij overschrijding 429.

Lees het overzicht Aanvragen

# click-to-call: toestel 1001 gaat eerst over, zodra er wordt opgenomen wordt het doel gebeld curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # campagne aanmaken 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"}}' # spraakverificatiecode versturen 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}

Documentatie

API-headers

Per rubriek het endpoint, de parameters, een voorbeeldverzoek en -antwoord.

Overzicht

Authenticatie, verzoekformaat, foutcodes, snelheidslimieten

Lezen

API-beveiliging

Sleutels, bereiken, toegestane IP's, HMAC-verzoekondertekening, sleutelvernieuwing, verzoeklogboek

Lezen

Gespreksbeheer

Click-to-call, beëindigen, doorverbinden, dempen

Lezen

Wachtrijen

Wachtrijlijst, wachtenden, leden toevoegen/verwijderen

Lezen

Medewerkerstatussen

Toestelstatussen en wachtrijlidmaatschappen

Lezen

Zwarte lijst

Geblokkeerde nummers weergeven, toevoegen, verwijderen

Lezen

Geluidsbestanden

Lijst van aankondigingen, uploaden, bijwerken, verwijderen

Lezen

Automatisch bellen

Campagne opzetten, nummers toevoegen, resultaten ophalen, webhook

Lezen

Spraakassistent

Gesprekken, notities, afspraken, taakoproepen, insluiten

Lezen

Spraakverificatie (OTP)

Code versturen, verifiëren, status, webhook

Lezen

SMS API

Bulk-/gepersonaliseerde SMS, OTP-SMS, bezorgrapport, inkomende SMS, zwarte lijst

Lezen

Webhooks

Handtekeningverificatie, herhaalbeleid, gebeurtenisschema's

Lezen

Embedden (CRM iframe)

In uw centrale schermen en webtelefoonsoftware: code, ondertekende link, JavaScript-gebeurtenissen

Lezen

Webhooks

Laat de resultaten naar u komen, vraag er niet naar.

Resultaat van automatisch bellen, gespreksamenvatting van de spraakassistent, status van de verificatiecode — elke gebeurtenis wordt als JSON naar uw adres gePOST; de header X-Buluthat-Signature is de HMAC-SHA256-handtekening. Een mislukte aflevering wordt na 1 min → 6 uur opnieuw geprobeerd.

Webhook-documentatie

// PHP: handtekening verifiëren $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-brug

De spraakassistent vindt de klant in het CRM, opent een servicedossier, laat een notitie achter; "bellen met de assistent" wordt vanuit het CRM gestart. Kant-en-klaar, één sleutel.

Details

PHP-client

Een kant-en-klare PHP-klasse voor spraakverificatiecodes; verstuur/verifieer met twee regels. De andere endpoints zijn gewone HTTP en vanuit elke taal aan te roepen.

Voorbeeld

Insluitbaar live scherm

Live transcript van een assistentgesprek als iframe in het CRM; met een tijdelijk ondertekend token, zonder paneelsessie.

embed_url