Gestione chiamate
Avviate chiamate dal Suo software (click-to-call), terminate, trasferite o silenziate le chiamate in corso. Tutti gli endpoint chiave API (ambito call; Authorization: Bearer bt_… nell'intestazione, vedi Sicurezza API) con e GET si chiama con il metodo.
Limite di frequenza: 10 richieste al minuto. ID della chiamata (call_uuid)begin_calltorna nella risposta e nei dati delle chiamate in tempo reale.
GETAvvio chiamata (click-to-call)
Squilla prima l'interno indicato; quando l'interno risponde viene chiamato il numero di destinazione e le due parti vengono collegate.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Parametro | Obbligatorio | Descrizione |
|---|---|---|
Authorization (intestazione) | sì | Bearer bt_…, ambito call |
extension | sì | Interno a cui collegare la chiamata (es. 1001) |
destination | sì | Numero da chiamare. Per la Turchia 905321234567, per l'estero 00 + prefisso internazionale |
caller_id | no | Numero da mostrare nella chiamata esterna; se non indicato, quello predefinito dell'interno. Un numero non appartenente al Suo account 400 restituisce |
manual_answer | no | true si attende che l'interno risponda manualmente; se non indicato, sui dispositivi che lo supportano la risposta è automatica |
timeout | no | Durata dello squillo, 10-60 sec (predefinito 30) |
announcement_to_caller | no | ID dell'annuncio da riprodurre all'interno al momento della connessione |
announcement_to_callee | no | ID dell'annuncio da riprodurre alla persona chiamata al momento della connessione |
Risposta positiva: 200 OK, nel corpo l'ID della chiamata.
358c20bc-fd86-11e5-87a2-157d41a07454Esempi di risposte errate:
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETTermina la chiamata
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id invece di, è accettato anche il formato del percorso: /api/hangup/<call_uuid>. Risposta 200 OK.
GETTrasferisci la chiamata
Trasferisce la chiamata in corso a un interno o a un numero esterno.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Parametro | Descrizione |
|---|---|
id | ID della chiamata |
user_number | Interno di destinazione (es. 1002) oppure numero esterno (905321234567) |
GETSilenzia / riattiva l'audio
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (disattiva il microfono) oppure off (attiva l'audio).
Dati delle chiamate in tempo reale
L'elenco delle chiamate in corso (chiamante, chiamato, interno, stato, durata) si legge dall'endpoint del ponte CRM; per aprire la scheda cliente su una chiamata in entrata usi questi dati oppure i webhook. Per i dettagli richieda dal Centro Assistenza il documento sul "ponte CRM"; per il CRM Byfix il ponte è già pronto.
Flusso tipico: click-to-call dal 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