Centro assistenza
Support
Apri l’app

Incoming Webhook

Caricare dati dal tuo CRM o sistema quando squilla il telefono e usarli come variabili nel saluto e nel prompt. Richiesta, risposta, valori di riserva e statistiche.

Disponibile in: ProIndividualUltima verifica il 25 ottobre 2026

Con l'Incoming Webhook il tuo agente sa chi sta chiamando già quando squilla il telefono. bhomy invia il numero di chi chiama al tuo URL, il tuo sistema risponde con dati come nome, numero cliente o ultimo ordine, e l'agente li usa come variabili. Così saluta per nome i clienti abituali o conosce lo stato di un ordine.

Come funziona

  1. Arriva una chiamata.
  2. bhomy invia una richiesta con i dati della chiamata al tuo URL.
  3. Il tuo sistema cerca chi chiama e risponde con un oggetto JSON.
  4. Ogni campo della risposta è disponibile come variabile, ad esempio {{name}}.
  5. L'agente saluta chi chiama con i valori della tua risposta.

Il webhook funziona per le chiamate in entrata. Per le chiamate in uscita passi i dati direttamente nel context dell'API Outbound.

Configurazione

  1. Apri il tuo agente e resta nella scheda Personalità.
  2. Apri la sezione Webhook in entrata e attiva Webhook attivato.
  3. Scegli il Metodo: POST o GET.
  4. Inserisci l'URL del webhook, ad esempio l'URL di produzione di un webhook n8n.
  5. Imposta il Timeout (ms). Consigliamo da 3000 a 5000 millisecondi.
  6. Facoltativo: inserisci gli Headers HTTP, ad esempio Authorization con un token segreto.
  7. Facoltativo: definisci un Template del corpo della richiesta. Se lo lasci vuoto, bhomy invia tutte le variabili disponibili.
  8. Imposta i Valori di riserva per il caso in cui il tuo sistema non risponda.
  9. Controlla tutto con Testa webhook › Invia test e salva.

La richiesta

Senza un template personalizzato, bhomy invia questi campi. Con POST come JSON nel corpo, con GET come parametri di query:

CampoContenuto
callIdID univoco della chiamata
fromNumbernumero di chi chiama nel formato E.164
toNumbernumero chiamato nel formato E.164
roomNameidentificativo interno della sessione di conversazione
participantIdentityidentificativo interno di chi chiama nella sessione
assistantIdID del tuo agente
assistantNamenome del tuo agente
{
  "callId": "call_8f2a1c",
  "fromNumber": "+491701234567",
  "toNumber": "+494012345678",
  "roomName": "call-8f2a1c",
  "participantIdentity": "sip_+491701234567",
  "assistantId": "6a90…",
  "assistantName": "Reception Studio Sommer"
}

Con un tuo Template del corpo della richiesta stabilisci tu la struttura e inserisci i campi come segnaposto, ad esempio:

{ "phone": "{{fromNumber}}", "line": "{{toNumber}}", "source": "bhomy" }

La risposta

Rispondi con lo stato 200 e un oggetto JSON piatto. Ogni campo diventa una variabile:

{
  "name": "Anna Berger",
  "customer_number": "K-10442",
  "last_appointment": "12 ottobre",
  "open_invoice": "no"
}

Nel prompt e nel saluto usi i valori con doppie parentesi graffe:

Saluto: Buongiorno {{name}}, grazie per aver chiamato. Come posso aiutarla?

Tempi e valori di riserva

Il saluto aspetta che il tuo webhook abbia risposto. Se il tuo sistema non risponde con 200 o non entro il timeout, bhomy riprova altre 2 volte dopo una breve pausa. Se anche così non arriva risposta, la conversazione inizia con i Valori di riserva. Ogni valore di riserva vale anche quando la tua risposta non contiene un campo.

VariabileValore di riservaSaluto senza risposta
namegentile cliente«Buongiorno gentile cliente …»

In Valori di riserva mancanti la dashboard elenca ogni variabile presente nel prompt o nel saluto senza valore di riserva. Senza valore di riserva e senza risposta, bhomy rimuove il segnaposto.

Sicurezza

PuntoConsiglio
AutenticazioneVerifica nel tuo sistema un header segreto, ad esempio Authorization: Bearer …. Non ci sono indirizzi IP fissi, l'agente chiama dal cloud
CrittografiaUsa un indirizzo HTTPS
Minimizzazione dei datiRispondi solo con i campi che servono all'agente nella conversazione. Tutto ciò che è nella risposta può essere detto a chi chiama

Statistiche e ultime chiamate

In Statistiche Webhook vedi per le ultime 24 ore il numero di chiamate, il tasso di successo, il tempo medio di risposta e gli errori. Ultime chiamate webhook mostra ogni chiamata singolarmente. Le statistiche si riempiono dalla prima chiamata reale. In caso di molti errori, vedi Problemi con i webhook.