Come collegare un agente AI ai tuoi sistemi

Per collegare un agente AI ai sistemi della tua azienda servono due collegamenti: gli strumenti (tool) che l'agente richiama durante la conversazione per leggere o modificare i dati nei tuoi sistemi (chiamate API), e i webhook che inviano eventi, come una nuova prenotazione, agli altri software che usi. La maggior parte delle aziende è indietro: il 2026 Connectivity Benchmark Report di MuleSoft ha rilevato che l'organizzazione media ha collegato solo il 27% delle proprie applicazioni, e l'86% dei responsabili IT concorda sul fatto che, senza un'integrazione adeguata, gli agenti AI rischiano di aggiungere più complessità che valore. Se imposti bene entrambe le direzioni, l'agente smette di essere una FAQ parlante.

Questa guida è pensata per il titolare o il responsabile operativo che deve prendere questa decisione senza essere uno sviluppatore. La strategia l'abbiamo già spiegata in perché la proliferazione di strumenti AI frena i ricavi. Questo articolo è il seguito pratico: cosa collegare, in quale direzione e come farlo in sicurezza.

Perché un agente AI deve collegarsi ad altri sistemi?

Perché i clienti fanno domande le cui risposte si trovano altrove. "Il mio ordine è stato spedito?" sta nel tuo negozio online. "Avete posto giovedì alle 16?" sta nel tuo calendario. "Sono ancora nel piano gold?" sta nel tuo CRM o nel software di gestione degli abbonamenti.

Un agente che non raggiunge quei sistemi ha due opzioni, entrambe pessime. Tira a indovinare (e ottieni una risposta sbagliata data con sicurezza), oppure passa ogni domanda di questo tipo a una persona (e hai pagato una risposta automatica molto costosa). Basare l'agente sulle tue conoscenze, come abbiamo spiegato in come addestrare un agente AI sulla tua attività, copre le domande con risposte stabili. Le integrazioni coprono quelle la cui risposta cambia di minuto in minuto o da cliente a cliente.

Il costo di saltare questo passaggio emerge dai dati. Nello stesso sondaggio MuleSoft su 1.050 responsabili IT, l'82% ha indicato l'integrazione dei dati come una delle sfide più grandi nell'uso dell'AI, e metà di tutti gli agenti AI oggi opera in silos anziché come parte di un sistema connesso.

Qual è la differenza tra API, webhook e strumento personalizzato?

Questi tre termini vengono usati come sinonimi. Non lo sono, e la differenza riguarda soprattutto chi avvia la conversazione.

	Chi la avvia	Direzione	Uso tipico con un agente AI
API	Chi effettua la chiamata	Richiesta, poi risposta	Il meccanismo generale: un sistema chiede a un altro dei dati o di eseguire un'azione
Strumento personalizzato (detto anche funzione o azione)	L'agente AI, durante la chat	L'agente legge o scrive nel tuo sistema	"Cerca l'ordine 4471", "controlla i punti fedeltà", "apri un ticket"
Webhook	La tua piattaforma per agenti, quando si verifica un evento	Inviato al tuo sistema	"È stata creata una prenotazione" inviato al tuo CRM, a un foglio di calcolo o a Slack
Integrazione nativa	Già pronta, fornita dal vendor	Di solito entrambe	Un collegamento al negozio online o al CRM che attivi invece di costruirlo

Uno strumento personalizzato è una chiamata API che l'AI decide di fare. Descrivi cosa fa lo strumento, di quali input ha bisogno e dove inviare la richiesta. Il modello legge quella descrizione e sceglie quando usarlo, proprio come un nuovo assunto legge una procedura e decide quando si applica.

Quella descrizione conta più di quanto molti pensino. Il team di ingegneria di Anthropic ha scritto in Building effective agents che, mentre costruivano il loro agente per SWE-bench, hanno "dedicato più tempo a ottimizzare i nostri strumenti che il prompt complessivo". Una descrizione vaga è uno dei motivi più comuni per cui un agente richiama lo strumento sbagliato o non richiama mai quello giusto.

Quali sistemi conviene collegare per primi?

Parti dalla domanda a cui il tuo team risponde più spesso andando a cercare un dato. Non l'integrazione più spettacolare: la ricerca più frequente.

Prenotazioni e calendario. Se i clienti prenotano appuntamenti, l'agente deve vedere la disponibilità reale e registrare prenotazioni reali, altrimenti farà doppie prenotazioni. (Spieghiamo il meccanismo in come funziona la prenotazione degli appuntamenti con l'AI.)
Ordini e catalogo. Per un negozio, "dov'è il mio ordine" e "ce l'avete in taglia M" sono gran parte dei messaggi in arrivo.
CRM o schede contatto. Così un lead acquisito in un DM finisce dove il tuo team commerciale lavora già, con la conversazione allegata.
Notifiche al team. Un webhook verso Slack o l'email quando arriva un lead caldo o una richiesta di passaggio a un operatore, così una persona lo vede nel giro di pochi minuti.
Tutto il resto (fedeltà, ticketing, ERP) quando i primi quattro sono stabili.

Un test utile prima di collegare qualsiasi cosa: sai indicare il campo esatto di cui l'agente ha bisogno e il sistema a cui appartiene? Se la risposta è "si trova in tre posti e non coincidono", sistema prima i dati. MuleSoft ha rilevato che i team IT dedicano già il 36% del loro tempo a sviluppare e testare integrazioni personalizzate; un agente collegato a dati disordinati eredita il disordine.

Come si scrive uno strumento personalizzato che l'AI userà davvero nel modo giusto?

Tratta ogni strumento come un mansionario per un assistente che prende tutto alla lettera.

Un compito per strumento. "Stato dell'ordine" e "annulla ordine" sono due strumenti, non uno solo con un selettore di modalità. Gli strumenti più piccoli sono più facili da scegliere per il modello e più facili da limitare per te.
Dagli il nome con cui lo chiederebbe un cliente. get_order_status è meglio di ord_lookup_v2.
Spiega quando usarlo e quando no. "Usalo quando il cliente fornisce un numero d'ordine o chiede dove si trova il suo pacco. Non usarlo per i resi."
Definisci ogni input. Tipo, formato, un esempio e se è obbligatorio. "Numero d'ordine, solo cifre, per esempio 4471."
Restituisci solo ciò che serve all'agente. Se la tua API restituisce 60 campi, prima o poi l'agente ne leggerà ad alta voce uno che non doveva. Riduci la risposta, oppure metti davanti un piccolo endpoint che lo faccia.
Rendi le azioni di scrittura reversibili o da confermare. Leggere i dati comporta pochi rischi. Annullare, rimborsare o modificare una prenotazione dovrebbe essere facile da annullare oppure richiedere la conferma del cliente (o di una persona).

Come si mantiene sicuro un agente AI integrato?

Collegare un agente ai tuoi sistemi amplia ciò che può andare storto, e gli sviluppatori lo sanno. Nel 2025 State of the API Report di Postman, un sondaggio su oltre 5.700 sviluppatori, gli agenti AI fuori controllo erano la principale preoccupazione di sicurezza: il 50,8% ha citato chiamate API non autorizzate o eccessive, il 49% temeva che l'AI accedesse a dati che non dovrebbe vedere e circa il 46% che l'AI facesse trapelare le credenziali API.

L'OWASP GenAI Security Project chiama questo rischio Excessive Agency (LLM06:2025) e lo riconduce a tre cause principali: funzionalità eccessive, permessi eccessivi e autonomia eccessiva. Ognuna corrisponde a una voce della checklist:

Causa principale (OWASP)	Come si presenta	Cosa fare
Funzionalità eccessive	Un unico strumento "tuttofare" che può leggere, scrivere ed eliminare	Dividilo in strumenti specifici; dai all'agente solo quelli che gli servono
Permessi eccessivi	Lo strumento usa una chiave API da amministratore	Crea una chiave dedicata con l'ambito minimo; sola lettura ovunque sia possibile
Autonomia eccessiva	Rimborsi o annullamenti senza alcun controllo	Richiedi conferma o approvazione umana per tutto ciò che è costoso o irreversibile

Altre quattro voci che è facile trascurare:

Considera inaffidabile il testo dei clienti. Un cliente può scrivere istruzioni in una chat. L'agente non deve mai passare l'input grezzo del cliente a un'azione sensibile senza validarlo. La nostra guida su prompt injection e come proteggere il tuo agente AI descrive l'attacco nel dettaglio.
Verifica ogni webhook che ricevi. Controlla la firma di ogni consegna, così uno sconosciuto non può inviare falsi eventi "prenotazione creata" al tuo endpoint.
Tieni i segreti fuori dai prompt. Le chiavi API vanno nella configurazione cifrata, mai nelle istruzioni dell'agente, dove una domanda furba potrebbe farle emergere.
Testa le azioni di scrittura con dati di prova. Esegui prima i tuoi strumenti su un account sandbox, poi tieni d'occhio con attenzione la prima settimana di chiamate reali.

Come gestisce le integrazioni Entagl?

Il Receptionist di Entagl è progettato per compiere azioni nei tuoi sistemi, quindi entrambe le direzioni fanno parte del prodotto:

Funzioni personalizzate (chiamate in uscita effettuate dall'agente). Definisci il nome, una descrizione in linguaggio semplice, gli input e l'endpoint, con GET, POST, PUT, PATCH o DELETE e i tuoi header. Gli header che contrassegni come segreti vengono salvati cifrati (AES-256-GCM) e decifrati solo al momento della chiamata. L'URL di ogni chiamata viene controllato per bloccare le richieste verso indirizzi di rete privati o interni. Nella chat di prova del titolare, le chiamate GET vengono eseguite davvero, mentre gli altri metodi vengono mostrati ma non inviati, così puoi fare le prove senza modificare i dati reali. Le funzioni personalizzate sono disponibili nei piani a pagamento.
Webhook in uscita (eventi inviati ai tuoi sistemi). Oltre 50 tipi di evento tra prenotazioni, contatti, conversazioni, passaggi a un operatore, messaggi, ordini, moduli e chiamate. Ogni consegna è firmata con HMAC-SHA256 in un header X-Entagl-Signature. Per la maggior parte degli eventi, il contenuto dei messaggi e i dati dei contatti sono disattivati per impostazione predefinita e sei tu a scegliere di includerli. Le consegne non riuscite vengono ritentate secondo uno schema progressivo che va da 30 secondi fino a 24 ore.
Connessioni native per Shopify e HubSpot, più un canale API pubblico per inviare messaggi all'agente dal tuo software e ricevere le risposte su un URL di callback firmato.

Dato che è un'unica piattaforma, la stessa scheda cliente sta dietro alla chat, alla prenotazione, alla chiamata di conferma del Coordinator e al webhook che riceve il tuo CRM. Colleghi ogni sistema una volta sola, non una volta per ogni strumento.

Cosa le integrazioni non risolvono

Il collegamento è necessario, ma non basta. MuleSoft riporta che il 64% dei responsabili IT teme di non raggiungere i propri obiettivi AI a breve termine, nonostante l'adozione sia quasi universale. Se le regole di prenotazione esistono solo nella testa di una persona o i dati dei prodotti non sono aggiornati, un'integrazione rende l'agente sbagliato più in fretta. La nostra checklist su perché la maggior parte dei progetti pilota di AI non arriva mai in produzione è una buona lettura da affiancare prima di iniziare.

FAQ

Mi serve uno sviluppatore per collegare un agente AI ai miei sistemi?

Per le integrazioni native (un negozio online o un CRM che attivi), di solito no. Per uno strumento personalizzato serve un endpoint API dall'altra parte e qualcuno in grado di leggerne la documentazione, magari il tuo sviluppatore web per un pomeriggio. Spesso puoi ricevere i webhook con uno strumento di automazione che usi già.

Qual è la differenza tra un webhook e una chiamata API?

Con una chiamata API, sei tu a chiedere qualcosa e ad aspettare la risposta. Con un webhook, è l'altro sistema ad avvisarti quando succede qualcosa, senza che tu lo chieda. Gli agenti AI usano le chiamate API (tramite gli strumenti) per recuperare dati durante la conversazione, e i webhook per avvisare gli altri sistemi dopo un evento.

MCP sostituisce webhook e strumenti personalizzati?

No. Il Model Context Protocol è uno standard con cui le applicazioni AI scoprono e richiamano strumenti, e la sua adozione è in crescita: il 39% degli intervistati nel sondaggio MuleSoft lo usa già. Standardizza il lato degli strumenti. I webhook continuano a gestire la direzione "avvisami quando succede qualcosa". Il nostro articolo su protocolli e guardrail per agenti AI approfondisce MCP e gli standard agent-to-agent.

Un agente AI può modificare i dati nei miei sistemi o solo leggerli?

Può fare entrambe le cose, se gli dai uno strumento che scrive. Proprio per questo conviene partire in sola lettura, aggiungere gli strumenti di scrittura uno alla volta e richiedere una conferma per tutto ciò che costa denaro o non si può annullare.

Cosa dovrei collegare per primo?

Ciò che il tuo team cerca più spesso per rispondere ai clienti. Per le attività su appuntamento è il calendario; per i negozi sono ordini e magazzino; per i team guidati dalle vendite è il CRM.

Vuoi vedere come funzioni personalizzate e webhook si collegherebbero al tuo sistema di prenotazione, al tuo negozio o al tuo CRM? Prenota una demo di 30 minuti e mapperemo insieme a te le tue prime tre integrazioni.

Fonti: MuleSoft 2026 Connectivity Benchmark Report (sondaggio su 1.050 responsabili IT, febbraio 2026); Postman 2025 State of the API Report (oltre 5.700 intervistati, ottobre 2025); OWASP LLM06:2025 Excessive Agency; Anthropic, Building effective agents. I dettagli sulle funzionalità di Entagl riflettono il prodotto a ottobre 2026.