Vai alla navigazione
Integrazioni

Webhook

Offri al tuo receptionist strumenti personalizzati che chiamano i tuoi endpoint HTTP.

L’integrazione Webhook Tool espone i tuoi endpoint HTTP come strumenti che il tuo receptionist o assistente aziendale può chiamare durante le conversazioni. L’IA decide quando chiamare l’endpoint in base alla conversazione.

Come funzionano gli strumenti webhook

Quando crei uno strumento webhook, definisci:

  1. Un endpoint HTTP da chiamare.
  2. Una descrizione della sua funzione, affinché l’IA sappia quando utilizzarlo.
  3. I parametri che l’IA deve raccogliere dalla conversazione.

Durante una chiamata, quando la conversazione corrisponde allo scopo dello strumento, il tuo receptionist raccoglie i parametri, chiama l’endpoint e utilizza la risposta per continuare la conversazione.

Creare uno strumento webhook

Vai a Integrazioni, seleziona Aggiungi integrazione e scegli Webhook Tool. Configura i campi seguenti e seleziona Abilita. Puoi aggiungere più strumenti webhook.

CampoDescrizione
NomeNome dello strumento visualizzato dall’IA, ad esempio check_order_status
DescrizioneQuando e perché utilizzare questo strumento
MetodoGET, POST, PUT, PATCH o DELETE
URLIl tuo endpoint HTTP
Timeout della risposta (secondi)Quanto attendere il tuo server: da 5 a 120 secondi, predefinito 20
Assegna agli agentiReceptionist, Agente assistente o entrambi
Disabilita le interruzioniImpedisce al chiamante di interrompere mentre lo strumento è in esecuzione
Header della richiestaHeader facoltativi inviati con ogni richiesta, ad esempio una chiave API
Parametri del bodyParametri inviati nel body della richiesta
Parametri queryParametri inviati come stringhe di query URL

Parametri

Ogni parametro include:

  • Chiave: il nome del campo.
  • Tipo: string, number o boolean.
  • Descrizione: il valore che l’IA deve estrarre dalla conversazione.
  • Obbligatorio: se l’IA deve raccoglierlo prima della chiamata.

Casi d’uso

ScenarioDescrizioneMetodo
Ricerca CRMCerca le informazioni del cliente nel tuo sistemaGET
Controllo dell’inventarioControlla la disponibilità dei prodotti in tempo realeGET
Acquisizione leadInvia i dati del chiamante al tuo sistema di marketingPOST
Creazione ticketCrea un ticket di assistenza durante la chiamataPOST
PreventivoCalcola un preventivo personalizzato in base alle esigenze del chiamantePOST

Esempio

Un’azienda idraulica crea uno strumento webhook:

  • Nome: check_service_area
  • Descrizione: “Controlla se serviamo il CAP del chiamante e qual è la prossima fascia oraria disponibile.”
  • URL: https://api.mybusiness.com/check-area
  • Metodo: POST
  • Header della richiesta: Authorization impostato sulla chiave API dell’azienda
  • Parametri del body: zip_code (string, obbligatorio), service_type (string, obbligatorio)

Quando un chiamante chiede informazioni sul servizio nella sua zona, il receptionist raccoglie il suo CAP, chiama il webhook e gli comunica il risultato.

Gli strumenti webhook sono disponibili in tutti i piani.