Problemi con i webhook
L'Incoming Webhook non risponde, mancano valori nella conversazione, il saluto arriva in ritardo o le statistiche mostrano errori.
Quando squilla il telefono, l'Incoming Webhook carica dati dal tuo sistema, ad esempio il nome di chi chiama dal tuo CRM. La risposta è poi disponibile come variabili nel saluto e nel prompt. Le Statistiche Webhook delle ultime 24 ore e le Ultime chiamate webhook nella scheda Personalità mostrano se funziona bene.
Il webhook non riesce
| Possibile causa | Soluzione |
|---|---|
| Il tuo endpoint non risponde con lo stato 200 | Solo una risposta con 200 conta come successo. Controlla il log del tuo sistema |
| La risposta non è un oggetto JSON | Rispondi con un oggetto, ad esempio {"name": "Mario Rossi"}. Un elenco o del testo semplice non viene acquisito come variabili |
| Gli header mancano o sono sbagliati | Controlla nome e valore in Headers HTTP, ad esempio Authorization: Bearer … |
| Il Template del corpo della richiesta non è un JSON valido | La dashboard mostra Formato JSON non valido. Lascia vuoto il campo: bhomy invierà tutte le variabili disponibili |
| Il tuo endpoint accetta solo determinati indirizzi IP | L'agente chiama dal cloud, senza un indirizzo IP fisso. Proteggi l'endpoint con un header invece che con una lista di IP consentiti |
Come verificarlo: clicca su Testa webhook › Invia test. bhomy invia una richiesta con dati di esempio e mostra la risposta.
Il saluto arriva in ritardo
Il saluto aspetta che il tuo webhook abbia risposto, perché può contenerne dei valori. Se il tuo sistema non risponde in tempo, bhomy riprova altre 2 volte. Solo dopo la conversazione inizia con i Valori di riserva.
| Soluzione | Effetto |
|---|---|
| Ridurre il timeout, consigliato da 3000 a 5000 millisecondi | Un sistema lento ritarda meno il saluto |
| Rispondere velocemente | Leggi solo i campi che ti servono e usa un indice per la ricerca per numero di telefono |
| Impostare valori di riserva | La conversazione suona naturale anche senza risposta |
Mancano valori nella conversazione
| Possibile causa | Soluzione |
|---|---|
| Il segnaposto ha un nome diverso dal campo nella risposta | {{first_name}} richiede esattamente "first_name" nella risposta |
| Il valore si trova in un oggetto annidato | Rispondi con una struttura piatta, ad esempio {"customer_name": "…"} invece di {"customer": {"name": "…"}} |
| Il webhook non è riuscito e non c'è un valore di riserva | Imposta un sostituto in Valori di riserva. La dashboard elenca le variabili senza valore di riserva in Valori di riserva mancanti |
Le statistiche mostrano un tasso di errore elevato
Il messaggio Tasso di errore elevato! compare quando molte chiamate al webhook delle ultime 24 ore non sono riuscite. Apri Ultime chiamate webhook: per ogni chiamata vedi se è riuscita e quanto è durata. Se si accumulano i timeout, il tuo sistema è troppo lento. Se si accumulano i codici di errore, controlla l'indirizzo e gli header.
Il webhook dopo la chiamata non arriva
È lo strumento Ticket CRM in Automazione. Vedi Integrazioni.
Ulteriore aiuto
Inviaci l'ora della chiamata, il tempo di risposta indicato in Ultime chiamate webhook e il codice di stato del tuo sistema, vedi Segnalare un problema.
Questa pagina ti è stata utile?