Come creare un agente WhatsApp con OpenAI Agents SDK

OpenAI Agents SDK è il framework open source di OpenAI per creare agenti: un modello con istruzioni, strumenti che può richiamare, handoff verso altri agenti e guardrail su input e output, il tutto eseguito in un ciclo finché il compito non è concluso. È un ottimo modo per creare un agente. Da solo, però, non ti dà un numero WhatsApp, un’inbox del team, i messaggi template o un modo per far subentrare una persona. Con Agent Harness di MonoChat scegli OpenAI Agents SDK come Harness IA, inserisci un nodo Agente IA in un flusso, colleghi WhatsApp e fai la prova, e al resto pensa MonoChat.

Questa guida spiega cosa ti offre l’SDK, i tre modi per usare gli agenti OpenAI in MonoChat, una configurazione passo dopo passo e i dettagli specifici di WhatsApp che decidono se i clienti si fidano dell’agente.

Cosa ti offre OpenAI Agents SDK

L’SDK si basa su un piccolo insieme di idee:

• Agenti: un modello più le istruzioni che ne descrivono il compito.
• Strumenti: funzioni che l’agente può richiamare, come “cerca un ordine” o “controlla uno slot orario”, oltre ai server MCP.
• Handoff: un agente che passa il compito a un altro specializzato, ad esempio da un agente di assistenza generale a un agente per i resi.
• Guardrail: controlli che girano insieme all’agente per bloccare input o output indesiderati.
• Sessioni e tracing: memoria tra i turni e un registro di ciò che l’agente ha fatto, passo dopo passo.

Insieme, questo è un agent harness: il ciclo che permette a un modello di agire, verificare il proprio lavoro e proseguire, invece di rispondere una sola volta. Nella messaggistica con i clienti, è la differenza tra spiegare la tua policy sui resi e creare davvero il reso.

Cosa aggiunge WhatsApp al problema

Creare l’agente è solo metà del lavoro. Metterlo davanti ai clienti su WhatsApp significa gestire:

• La piattaforma WhatsApp Business. Una connessione API ufficiale, un’azienda verificata e un numero approvato.
• La finestra di 24 ore. Le risposte libere sono consentite entro 24 ore dall’ultimo messaggio del cliente; dopo serve un template approvato.
• Le policy. Dal 15 gennaio 2026 WhatsApp esclude dalla piattaforma gli assistenti IA generici. Un agente che serve i tuoi clienti è consentito e, quando le risposte sono automatiche, ci si aspetta una via chiara verso una persona.
• Le persone. Alcune conversazioni devono andare a una persona, con la cronologia intatta, nello strumento che il tuo team già usa.
• Gli altri canali. I clienti che scrivono su Instagram, Messenger o sul tuo sito web si aspettano le stesse risposte.

MonoChat gestisce tutto questo attorno all’agente, così il tuo lavoro resta sull’agente stesso.

Tre modi per usare gli agenti OpenAI in MonoChat

Opzione	Dove viene eseguito	Cosa ti serve
OpenAI Agents SDK	All’interno di MonoChat	Niente di extra; usa i tuoi modelli IA
OpenAI Agents API (ospitata da OpenAI)	Il cloud di OpenAI	La tua chiave API OpenAI
Personalizzato (il tuo servizio Agents SDK)	Il tuo server	Un URL endpoint e un segreto condiviso

Inizia con l’harness OpenAI Agents SDK se vuoi un agente in stile OpenAI senza distribuire nulla. Scegli OpenAI Agents API se i tuoi agenti vivono già sulla piattaforma ospitata di OpenAI. Scegli Personalizzato se i tuoi sviluppatori hanno scritto un proprio agente con l’SDK, con i propri strumenti, handoff e test, e vogliono continuare a eseguire quel codice; vedi come collegare il tuo agente IA a WhatsApp.

Passo dopo passo: un agente OpenAI Agents SDK su WhatsApp

1. Aggiungi un Harness IA

Aggiungi un Harness IA in MonoChat e scegli OpenAI Agents SDK come provider. Gira all’interno di MonoChat e usa i modelli IA che hai già configurato, quindi per questo passaggio non servono chiavi o server aggiuntivi.

2. Aggiungi un nodo Agente IA a un flusso

Nel flusso che riceve le tue conversazioni WhatsApp, aggiungi un nodo Agente IA e seleziona l’harness. Scrivi le istruzioni dell’agente: chi serve, cosa può fare, cosa non deve mai fare e quando passa la mano.

3. Scegli i modelli principale, di fallback e veloce

Ogni nodo Agente IA ha tre ruoli dei modelli:

• Il modello principale ragiona e scrive le risposte.
• Il modello di fallback subentra dopo un limite soft o un errore.
• Il modello veloce gestisce il lavoro in background.

Aggiungi un limite di budget per esecuzione perché una conversazione insolita non faccia salire il conto. Non sai come scegliere il fallback? Leggi perché il tuo agente IA a contatto con i clienti ha bisogno di un modello di fallback.

4. Collega i tuoi strumenti

Dai all’agente gli strumenti che corrispondono alle tue richieste più frequenti:

• Strumenti di funzione IA per chiamare le tue API con input strutturati.
• Integrazione MCP per gli strumenti dei sistemi compatibili con MCP.
• La base di conoscenza IA per risposte fondate sui tuoi documenti e sulle tue policy.
• Le funzioni personalizzate per la logica che gira all’interno della conversazione.

Tre buoni strumenti valgono più di quindici testati a metà. Aggiungine altri quando vedi le conversazioni reali.

5. Collega WhatsApp (e tutto il resto)

Collega il tuo numero WhatsApp Business tramite MonoChat, un Meta Business Partner ufficiale. Lo stesso flusso può girare su Instagram, Messenger, TikTok, Telegram, chat web, SMS e voce, così un solo agente copre ogni canale.

6. Testa con messaggi reali

Usa le conversazioni del mese scorso come set di test. Includi quelle difficili: clienti arrabbiati, domande vaghe, più richieste in un solo messaggio, un cliente che chiede subito una persona. Controlla le chiamate agli strumenti, il tono e il passaggio a un operatore. Poi vai online.

Schemi che funzionano bene su WhatsApp

Una domanda per messaggio. Gli agenti pensati per la chat sul web tendono a rispondere con lunghi elenchi. Su un telefono, messaggi brevi e una domanda chiara alla volta ottengono risposte migliori dai clienti.

Conferma prima delle azioni irreversibili. Lascia che sia l’agente a proporre e il cliente a confermare, prima di un annullamento, di un rimborso o di una modifica di prenotazione.

Specialisti tramite handoff, persone tramite l’inbox. Gli handoff dell’SDK sono ottimi per instradare tra agenti (vendite, assistenza, resi). Il passaggio a una persona appartiene all’inbox condivisa del team di MonoChat, dove la conversazione arriva con tutta la cronologia.

Istruzioni che indicano i limiti. “Puoi approvare rimborsi fino a €50; oltre, passa la mano al team fatturazione.” Numeri espliciti battono regole vaghe.

Resta nell’ambito della tua attività. Un agente che aiuta i tuoi clienti è consentito su WhatsApp. Uno che risponde a qualsiasi cosa rischia di violare le regole WhatsApp del 2026; la nostra guida alla policy WhatsApp sui chatbot IA spiega dove passa il confine.

Costi

Si sommano tre voci: il tuo piano MonoChat, l’uso dei modelli IA e le tariffe dei messaggi WhatsApp di Meta. Dal 1° ottobre 2026 Meta addebita le risposte di assistenza dopo le prime 1.000 per numero aziendale ogni mese; consulta la nostra guida ai prezzi delle API WhatsApp.

Sul lato IA, MonoChat non aggiunge alcun ricarico quando usi le chiavi del tuo provider. Budget per esecuzione, un modello veloce più economico per il lavoro in background e un fallback affidabile mantengono il conto prevedibile.

Nessun vincolo

Agent Harness ti permette di scegliere il framework, non solo il modello. Se in seguito vuoi provare Claude Agent SDK, Pi, Claude Managed Agents o il tuo framework, aggiungi un altro Harness IA e punta il nodo Agente IA su di esso. I tuoi canali, strumenti e passaggio a un operatore restano come sono. Confronta tutti i provider nella pagina Agent Harness.