Crea un bot WhatsApp con Claude Code o Codex, sul numero che tieni nell'app
Aggiungi un server MCP WhatsApp a Claude Code o Codex e lascia che l'agente di codifica faccia il setup: legge le credenziali Cloud API del numero, crea un ricevitore webhook, instrada verso di esso i messaggi in arrivo e invia una risposta di prova a chi ha scritto nelle ultime 24 ore. Quello che ottieni è il tuo agente, che gira come tuo codice sul tuo server.
easyCoexistence collega il numero WhatsApp Business che tieni nell'app alla Cloud API di Meta tramite Coexistence e offre a Claude Code e Codex più di 30 strumenti MCP per costruire: credenziali, instradamento, template, invii di prova e automazioni.
Flag di Claude Code che carica un server in tutti i tuoi progetti; l'ambito locale predefinito lo carica solo dove è stato aggiunto.
Comando di Codex che salva l'accesso OAuth di un server; senza credenziali, Codex può connettersi senza autenticazione.
Cosa deve usare una destinazione webhook diretta, e deve restituire hub.challenge nell'handshake GET di Meta.
Per quanto tempo il passaggio Call my webhook attende il {"reply"} del tuo endpoint prima che il passaggio fallisca.
Finestra di assistenza clienti dopo l'ultimo messaggio dell'utente; al di fuori di essa, Meta accetta solo messaggi template.
Throughput fisso di un numero usato sia con l'app WhatsApp Business sia con la Cloud API.
Di cosa ha bisogno un agente di codifica per costruire un agente WhatsApp?
Quattro cose. Un numero WhatsApp Business collegato alla Cloud API di Meta tramite Coexistence, così l'app resta sul telefono mentre il codice può inviare e ricevere. Una connessione MCP da Claude Code o Codex a quel numero, che permette all'agente di leggere le credenziali, modificare l'instradamento e inviare messaggi di prova senza aprire una dashboard. Un indirizzo HTTPS pubblico per il ricevitore, da un host su cui pubblichi o da un tunnel mentre sviluppi. E una chiave del modello per l'agente che stai costruendo.
Tieni distinti i due agenti. Claude Code o Codex è il costruttore: agisce solo mentre lavori con esso nel terminale. Il programma che scrive è quello che risponde ai clienti, e continua a funzionare dopo che chiudi la sessione.
Come aggiungi gli strumenti WhatsApp a Claude Code e Codex?
Ciascuno richiede un solo URL dal terminale e accede tramite OAuth, quindi nessuna chiave finisce in un file. In Claude Code, aggiungi il server con --scope user così viene caricato in ogni progetto, poi avvia claude, esegui /mcp, scegli easycoexistence e accedi nel browser. In Codex, aggiungi il server ed esegui codex mcp login, che salva l'accesso; codex mcp list mostra cosa è configurato. Codex conserva la voce in ~/.codex/config.toml, che anche l'app desktop ChatGPT e l'estensione IDE di Codex leggono.
Verifica che abbia funzionato chiedendo qualcosa che solo gli strumenti possono rispondere, come "elenca i miei numeri WhatsApp". L'agente chiama list_numbers e ottiene il connection_id di ogni numero, che ogni altro strumento richiede.
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp listQuale percorso deve costruire l'agente?
Tre percorsi portano il messaggio di un cliente al tuo codice, e si differenziano per quanto lavoro deve fare il codice. Per una prima versione, il passaggio Call my webhook è il più breve: easyCoexistence salta i duplicati, si ferma quando rispondi dal telefono e verifica la finestra di 24 ore prima di chiamare il tuo endpoint, così il tuo codice scrive solo la risposta. Passa a un Forward URL o a una destinazione diretta quando l'agente ha bisogno di tutti gli eventi, non solo dei messaggi selezionati da un'automazione.
Cosa devi chiedere all'agente di codifica?
Fornisci subito il percorso, la lingua e le regole, e chiedi un piano prima che scriva codice. Indica quali chiamate agli strumenti può fare da solo: leggere credenziali e documentazione è innocuo, mentre cambiare dove vanno i messaggi incide sul numero attivo. get_docs restituisce la documentazione di easyCoexistence, incluso come un ricevitore autentica le consegne, così l'agente può leggere le regole invece di indovinarle. Una richiesta come questa produce un ricevitore che puoi rivedere in una sola sessione:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.Come colleghi il ricevitore e lo testi?
Avvia il server dove Meta e easyCoexistence possono raggiungerlo tramite HTTPS, poi lascia che l'agente faccia l'instradamento. Per il percorso Forward URL, chiama set_inbound_mode con il tuo URL su un numero in Automations, in modalità on; il forward secret viene restituito una sola volta e l'agente lo scrive nel tuo .env. Per il percorso diretto, l'endpoint deve prima rispondere all'handshake GET di Meta, poi l'agente chiama set_webhook_destination con l'URL, un segreto casuale lungo nel suo percorso e il tuo verify token.
Per testare, scrivi al numero aziendale dal tuo telefono e osserva i log: il ricevitore dovrebbe vedere l'evento, il modello dovrebbe rispondere e la risposta dovrebbe comparire nella chat. Poiché hai appena scritto, la finestra di 24 ore è aperta, quindi l'agente di codifica può anche provare send_message verso il tuo numero.
L'agente finito ha ancora bisogno del server MCP?
No. Il server MCP è lo strumento del costruttore, con il tuo accesso. L'agente che pubblichi invia tramite la Graph API di Meta con send_endpoint e access_token restituiti da get_api_credentials, il token dell'azienda limitato alle sue risorse WhatsApp, e riceve tramite il percorso che hai impostato. Se access_token è tornato null, riconnettere il numero dalla dashboard ne emette uno senza sostituire un token che già funziona.
Mantieni la connessione MCP per il lavoro intorno all'agente: creare template con create_template, controllare get_number_health quando qualcosa non torna e leggere il log di esecuzione di qualsiasi automazione che passa messaggi al tuo codice.
Come configurarlo
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
Errori comuni
- Salvare un tunnel temporaneo come destinazione diretta nelle prime 24 ore. L'importazione una tantum di contatti e fino a 6 mesi di chat di Meta va a quell'URL e viene persa quando il tunnel si chiude.
- Impostare una destinazione diretta su un numero che esegue automazioni. Il numero passa a diretto e le sue automazioni si fermano; usa un Forward URL in Automations, in modalità on, per tenerle entrambe.
- Committare il .env scritto dall'agente. Aggiungilo prima a .gitignore, perché chiunque possieda il token di accesso può scrivere ai clienti come se fosse l'azienda.
- Testare send_message su un contatto che non ha scritto nelle ultime 24 ore. Meta rifiuta il testo libero fuori dalla finestra, quindi scrivi prima al numero dal tuo telefono.
Il tuo agente gira poi sul tuo server, e ogni numero è monitorato 24/7 con avvisi. Da US$ 9 a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.
Domande frequenti
Funziona anche in Cursor o in altri strumenti di codifica?
Sì. Qualsiasi client MCP che si connette a server remoti tramite Streamable HTTP con OAuth può usare lo stesso URL, inclusi Cursor, VS Code, Gemini CLI e Antigravity. Cambia solo il formato di configurazione da un client all'altro.
In quale linguaggio dovrebbe scrivere l'agente?
In qualsiasi linguaggio in grado di servire HTTPS e calcolare un HMAC-SHA256. Node.js e Python sono le scelte più comuni, e per entrambi ci sono esempi testati, con verifica della firma, gestione dei duplicati e la pausa quando rispondi dal telefono, nella pagina dell'agente Node.js e Python.
Mi servono una mia app Meta o una App Review?
No. Il numero entra nella Cloud API tramite l'app Meta di easyCoexistence e resta nel Business Portfolio dell'azienda. Il token con cui il tuo codice invia è quello dell'azienda, quindi non è coinvolta nessuna app Meta tua.
L'agente di codifica può creare i template di cui ha bisogno l'agente?
Sì, con create_template, poi get_template_status finché Meta risponde, di solito in pochi minuti e al massimo circa 24 ore. Il tuo agente ha bisogno di un template approvato per avviare una conversazione o per scrivere dopo la chiusura della finestra di 24 ore.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il