Centro sviluppatori

Faccia del Suo centralino una parte del Suo software.

Una sola chiave API, HTTP semplice, risposte JSON. Dal click-to-call e controllo chiamate alle campagne di chiamata automatica, dagli incarichi dell'assistente vocale al codice di verifica vocale, tutto è REST; i risultati tornano con webhook firmati HMAC.

Guida rapida

La Sua prima richiesta in 2 minuti

Prenda la Sua chiave da Pannello > Chiamata automatica > scheda API (oppure da Impostazioni del centralino); la invii con intestazione Bearer, X-Api-Key o ?key=.

La chiave è legata al Suo account cliente; non può accedere ai dati di altri clienti.
Le operazioni di lettura sono GET, quelle che modificano sono POST; corpo JSON o form.
La risposta di errore è sempre {"ok":false,"error":"…","code":"…"} è nel formato.
Limite di frequenza: 120 richieste al minuto per chiave; in caso di superamento 429.

Leggi la panoramica Invia richiesta

# click-to-call: l'interno 1001 squilla per primo, alla risposta viene chiamata la destinazione curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # crea campagna 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"}}' # invia codice di verifica vocale 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}

Documentazione

Intestazioni API

Per ogni intestazione: indirizzo dell'endpoint, parametri, richiesta e risposta di esempio.

Panoramica

Autenticazione, formato delle richieste, codici di errore, limiti di frequenza

Leggi

Sicurezza API

Chiavi e ambiti, IP autorizzati, firma HMAC delle richieste, rotazione delle chiavi, registro delle richieste

Leggi

Gestione chiamate

Click-to-call, termina, trasferisci, silenzia

Leggi

Code

Elenco code, in attesa, aggiungi/rimuovi membri

Leggi

Stati degli operatori

Stato degli interni e appartenenza alle code

Leggi

Lista nera

Elenca, aggiungi, elimina i numeri bloccati

Leggi

File audio

Elenco, caricamento, aggiornamento ed eliminazione degli annunci

Leggi

Chiamata automatica

Crea campagna, aggiungi numeri, ottieni risultati, webhook

Leggi

Assistente vocale

Conversazioni, note, appuntamenti, chiamate per incarico, incorporamento

Leggi

Verifica vocale (OTP)

Invia codice, verifica, stato, webhook

Leggi

API SMS

SMS di massa / personalizzati, SMS OTP, report di consegna, SMS in entrata, lista nera

Leggi

Webhook

Verifica della firma, politica di ripetizione, schemi degli eventi

Leggi

Incorporamento (iframe CRM)

Nei pannelli della centrale e nel software WebPhone: codice, link firmato, eventi JavaScript

Leggi

Webhook

Che i risultati arrivino a Voi, senza doverli chiedere.

Esito della chiamata automatica, riepilogo della conversazione dell'assistente vocale, stato del codice di verifica — ogni evento viene inviato in POST in JSON al Suo indirizzo; l'intestazione X-Buluthat-Signature è la firma HMAC-SHA256. Le consegne non riuscite vengono ritentate a intervalli di 1 min → 6 ore.

Documentazione dei webhook

// PHP: verifica della firma $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' …

Ponte CRM Byfix

L'assistente vocale trova il cliente nel CRM, apre la richiesta di assistenza, annota note; la chiamata "con l'assistente" si avvia dal CRM. Già pronto, una sola chiave.

Dettaglio

Client PHP

Classe PHP già pronta per il codice di verifica vocale; invia/verifica in due righe. Gli altri endpoint sono HTTP semplice e si chiamano da qualsiasi linguaggio.

Esempio

Schermata in diretta incorporabile

Trascrizione in diretta della conversazione dell'assistente in iframe all'interno del CRM; con token firmato a tempo, senza sessione del pannello.

embed_url