Chiamata API durante la conversazione
Con lo strumento Sistema CRM il tuo agente chiama il tuo sistema durante la chiamata per inserire o consultare dati, ad esempio un lead o lo stato di un ordine.
Con lo strumento Sistema CRM il tuo agente si collega al tuo sistema durante la conversazione. Chiede le informazioni che stabilisci e le invia via HTTP al tuo URL, ad esempio per creare un lead, aprire un ticket o consultare lo stato di un ordine. Se il tuo sistema risponde con dei dati, l'agente può comunicarli a chi chiama.
Quando usare questo strumento e quando un altro
| Obiettivo | Strumento |
|---|---|
| Inserire o consultare dati durante la conversazione | Sistema CRM nella scheda Strumenti |
| Caricare il contesto quando squilla il telefono | Incoming Webhook |
| Trasferire i dati della conversazione dopo la chiamata | Ticket CRM in Automazione, vedi n8n |
Creare lo strumento
La procedura guidata ti accompagna nella configurazione in quattro passaggi.
- Modello: apri Strumenti › Aggiungi › Sistema CRM. Scegli un settore, ad esempio artigianato, immobiliare o assicurazioni, oppure parti da zero.
- Parametri dinamici: stabilisci quali dati l'agente chiede durante la conversazione. Con Agente IA descrivi il tuo caso in una frase e ti fai proporre i parametri.
- Configura endpoint: inserisci nome dello strumento, testo di attesa, descrizione per l'IA e URL. In Impostazioni avanzate imposti timeout e header.
- Copia modello di prompt: bhomy genera una sezione per il tuo prompt. Copiala con Copia prompt e incollala nel prompt della scheda Personalità.
Parametri
Per ogni parametro stabilisci:
| Dato | Significato |
|---|---|
| Nome | nome del campo nel JSON inviato, ad esempio first_name |
| Tipo | Testo, Numero, E-mail, Telefono, Data, Sì/No o Selezione con opzioni separate da virgole |
| Obbligatorio | L'agente richiama lo strumento solo quando ha tutti i dati obbligatori |
| Domanda | come l'agente lo chiede, ad esempio «Qual è il suo nome completo?» |
| Descrizione | cosa va nel campo |
Endpoint
| Campo | Significato |
|---|---|
| Nome dello strumento | il nome con cui l'agente conosce lo strumento, ad esempio «Crea lead» |
| Testo di attesa | frase che l'agente pronuncia durante la chiamata API, ad esempio «Sto inserendo i suoi dati.» |
| Descrizione (per l'IA) | quando l'agente richiama lo strumento, ad esempio «Crea un nuovo lead. Richiamare solo quando tutti i campi obbligatori sono compilati.» |
| Endpoint Webhook | metodo POST o GET e l'URL del tuo sistema |
| Fire-and-Forget | attivo: solo invio, la risposta non viene valutata. Disattivo: l'agente riceve la risposta e può usarla |
| Timeout (ms) | quanto a lungo l'agente attende la risposta |
| Headers | ad esempio Authorization: Bearer … o X-Api-Key |
L'Anteprima del corpo della richiesta mostra cosa viene inviato. Con POST i parametri vanno come JSON nel corpo, con GET come parametri di query.
{
"first_name": "Anna",
"last_name": "Berger",
"phone": "+491701234567",
"request": "Preventivo per una pompa di calore"
}
La risposta del tuo sistema
Con Fire-and-Forget disattivato, bhomy passa la risposta del tuo sistema all'agente. Rispondi con un oggetto JSON che si possa leggere ad alta voce:
{ "status": "spedito", "delivery_date": "giovedì", "carrier": "DHL" }
L'agente ne ricava una risposta, ad esempio «Il suo ordine è stato spedito e arriverà giovedì con DHL.» Se il tuo sistema risponde con un errore o troppo tardi, l'agente dice a chi chiama che al momento non è stato possibile e propone un'altra strada. Non nomina codici di stato né messaggi di errore.
Sicurezza e velocità
| Punto | Consiglio |
|---|---|
| Autenticazione | Verifica un header segreto. Non ci sono indirizzi IP fissi |
| Velocità | Rispondi in pochi secondi. Chi chiama aspetta mentre il tuo sistema lavora |
| Dati | Restituisci solo ciò che l'agente può dire. Tutto ciò che è nella risposta può essere comunicato a chi chiama |
Ciò che l'agente ha inviato e ricevuto è riportato nello storico chiamate in Main Logs.
Questa pagina ti è stata utile?