Obiettivo
Permettere all’Agente AI di attivare automazioni esterne durante una conversazione. Quando si verifica la condizione che descrivi, eContact chiama un tuo webhook (gestionale, CRM, Make, Zapier…) con i dati raccolti in chat; se vuoi, la risposta del tuo sistema torna all’AI, che la usa per rispondere al cliente.
Prima di iniziare
Ti servono un URL webhook in HTTPS e un agente AI a cui assegnare il tool.
Passaggi
- Apri Agenti AI → Tool Personalizzati e clicca Crea tool.
- Nella Configurazione base inserisci: nome del tool (es. “Verifica stato pratica”), descrizione del trigger (quando l’AI deve usarlo, con condizioni ed eccezioni), URL webhook, eventuali header (es. chiave di autenticazione), cooldown in minuti tra due attivazioni per lo stesso telefono (0 = nessun limite) e timeout in secondi.
- Attiva Restituisce dati all’AI se il corpo della risposta deve tornare all’agente (es. disponibilità di un appuntamento); lascialo spento se il tool deve solo inviare dati.
- Con Aggiungi parametro definisci ogni dato da inviare: nome (lettere, numeri, underscore), tipo (String, Number, Boolean), obbligatorio sì/no e sorgente:
- Generato dall’AI: l’AI estrae il valore dalla chat seguendo la descrizione che scrivi;
- Valore statico: un valore fisso;
- Campo cliente: telefono, nome, cognome o email del contatto.
- Premi Testa: viene inviato un esempio (valori statici reali, gli altri come segnaposto) e vedi stato, latenza, risposta e payload inviato.
- Salva, verifica che l’interruttore del tool sia acceso, poi in Agenti AI → Strumenti e permessi attiva il tool per l’agente e clicca Salva.
- Nella scheda del tool controlla gli Invii recenti con esito e tentativi: gli invii falliti vengono ritentati in automatico. Le attivazioni compaiono anche nel Registro attività.
Da sapere
- Ogni chiamata include negli header un ID univoco di consegna e il nome del tool: usa l’ID per ignorare eventuali duplicati.
- Eliminare un tool cancella anche la cronologia degli invii e non è reversibile: per fermarlo temporaneamente usa l’interruttore.
Suggerimento
L’AI decide quando usare il tool in base alle descrizioni: scrivile in modo preciso, come istruzioni a un collega nuovo, e verifica sempre il payload con il test prima di andare in produzione.
