Dai a un assistente AIun vero numero WhatsApp.
Un server MCP permette a Claude, ChatGPT o Cursor di usare WhatsApp direttamente: elencare i tuoi numeri, controllarne lo stato, inviare messaggi e template e indirizzare i webhook ai tuoi sistemi. Il nostro funziona sulla Cloud API ufficiale di Meta, così il numero a cui i tuoi clienti scrivono già non corre mai rischi.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}A cosa si collega davvero il connettore
Un unico server remoto, raggiunto tramite OAuth, che chiama la Cloud API documentata di Meta su un numero ancora attivo nell'app WhatsApp Business. Nessuna sessione viene conservata da nessuna parte e nulla viene eseguito sul tuo computer.
- 1Il tuo assistenteClaude, ChatGPT, Cursor o Claude Code, tramite MCP
- 2easycoexistence.com/api/mcpRemoto, autorizzato con OAuth. Nessuna chiave da incollare da nessuna parte
- 3Meta Cloud APIGli endpoint Graph documentati, con il token dell'account stesso
- 4Il numero aziendaleCollegato tramite Coexistence, con l'app che continua a funzionare sul telefono
L'alternativa scelta dalla maggior parte delle automazioni WhatsApp è accedere come dispositivo collegato e pilotare la sessione di WhatsApp Web. Questo viola i termini di WhatsApp, e Meta lo rileva dalla forma del traffico e non dal codice che lo invia: per questo una promessa anti-ban descrive qualcosa che il fornitore non può controllare. Niente qui usa quel meccanismo.
Come installarlo
Un unico endpoint remoto, lo stesso per tutti i numeri dell'account. Nessun pacchetto da installare e nessuna chiave da generare: ogni client accede con OAuth la prima volta che chiama uno strumento.
- Apri Impostazioni e vai su Connettori.
- Scegli Aggiungi connettore personalizzato e incolla l'endpoint qui sotto.
- Salva, poi chiedi a Claude di elencare i tuoi numeri. La prima volta apre una schermata di accesso.
https://easycoexistence.com/api/mcp- Apri Impostazioni, vai su Connettori, poi su Avanzate, e attiva la Modalità sviluppatore.
- Aggiungi un connettore con l'endpoint qui sotto.
- Avvia una chat e chiedigli di elencare i tuoi numeri per far partire l'accesso.
https://easycoexistence.com/api/mcp- Esegui il comando qui sotto in un terminale qualsiasi.
- Esegui /mcp dentro Claude Code ed effettua l'autenticazione.
- Da quel momento gli strumenti sono disponibili in ogni sessione.
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- Apri Impostazioni e trova la sezione MCP.
- Aggiungi un server con la configurazione qui sotto.
- Ricarica, poi chiedi a Cursor di elencare i tuoi numeri.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Collegare un numero è un passaggio separato, da fare una sola volta e che richiede un browser, perché l'onboarding di Meta usa un proprio popup e la scansione di un QR. get_connect_link restituisce quel link se preferisci che sia l'assistente a fornirtelo.
Regole imposte dagli strumenti, così l'assistente non le impara a proprie spese
send_message funziona quando il destinatario ha scritto al numero nelle ultime 24 ore. Quelle risposte sono gratuite. Fuori da questo intervallo, send_template con un template approvato è l'unica cosa che viene consegnata, e la descrizione dello strumento lo dice, così l'assistente sceglie quello giusto senza che nessuno glielo indichi.
L'app sul telefono non può inviare un template su un numero Coexistence. Tutto ciò che è programmato, transazionale o fuori dalla finestra deve passare dall'API, ed è buona parte del motivo per cui si collega un numero.
Gli invii di marketing vengono addebitati da Meta sul metodo di pagamento della WhatsApp Business Account, configurato in WhatsApp Manager. Non passano mai da noi e non possiamo aggiungere una carta tramite l'API.
HTTPS, e su una GET con hub.mode=subscribe e il tuo hub.verify_token l'endpoint deve restituire hub.challenge. Lo verifichiamo prima della chiamata, così un URL sbagliato fallisce subito invece di sembrare collegato.
I sedici strumenti WhatsApp, e a cosa serve davvero ciascuno
Un solo connettore li espone tutti, su tutti i numeri dell'account, insieme agli strumenti per gli altri canali. list_numbers viene per primo perché ogni altro strumento WhatsApp prende da lì un connection_id.
list_numbersI numeri collegati con stato, valutazione della qualità e livello di messaggistica. Il punto di partenza per tutto il resto.get_number_healthUn'istantanea in tempo reale da Meta più la cronologia recente del monitoraggio: eventi webhook e controlli periodici insieme.get_api_credentialsURL base della Graph API, WABA id, phone number id e il token di accesso dell'account stesso, quando disponibile.
send_messageTesto libero, e solo dentro la finestra di assistenza di 24 ore. Le risposte dentro quella finestra sono gratuite.send_templateIl modo per avviare una conversazione con qualcuno che non ha scritto per primo.list_templatesI template dell'account con il relativo stato di revisione.create_templateLo invia a Meta per la revisione. UTILITY, MARKETING o AUTHENTICATION, con variabili in stile {{1}} che richiedono valori di esempio.get_template_statusAPPROVED, PENDING o REJECTED, per nome del template.
set_webhook_destinationInstrada i messaggi in arrivo e gli echi dell'app sul telefono da Meta direttamente al tuo sistema. Passa null per reimpostarlo.get_connect_linkRestituisce il link della dashboard e i passaggi per collegare un nuovo numero, dato che l'onboarding richiede un browser.get_docsL'intera documentazione del prodotto in markdown, così l'assistente risponde basandosi sulla nostra documentazione invece di tirare a indovinare.
get_partner_setupA che punto è la configurazione della Partner API: fatturazione, chiave API, URL degli eventi e il prossimo passo.create_api_keyEmette la chiave della Partner API e la mostra una sola volta. Non sostituisce una chiave esistente senza la tua conferma.revoke_api_keyRevoca la chiave della Partner API dopo la tua conferma. Da quel momento ogni richiesta fatta con essa fallisce.set_partner_events_urlImposta dove vengono inviati gli eventi di stato della connessione e restituisce il segreto di firma, mostrato una sola volta.create_connect_linkCrea un link di collegamento ospitato per uno dei tuoi clienti, valido 1 ora. Il numero viene addebitato sul tuo account.
Cosa continua a funzionare quando il pagamento si interrompe
Sono bloccati gli strumenti che agiscono sul mondo esterno, e anche get_api_credentials, perché consegna il token con cui si invia. La lettura di salute e stato resta aperta, di proposito.
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
Un account che non può vedere perché è bloccato, o non può controllare se i suoi numeri sono in buono stato, non ha altra via d'uscita che un ticket all'assistenza. Quelle due letture sono anche ciò su cui si basa il monitoraggio dello stato stesso.
La coppia che conta se lavori per altre aziende
get_connect_link restituisce il link che un cliente apre per collegare il proprio numero, e set_webhook_destination indirizza quel numero al tuo sistema nel momento in cui si collega. Insieme permettono a un agente di attivare un cliente dall'inizio alla fine senza che nessuno apra una dashboard.
Un account contiene tutti i numeri che ti servono, ciascuno fatturato separatamente, e list_numbers li restituisce tutti con il connection_id richiesto da ogni altro strumento.
Strumenti per leggere, inviare, usare template, configurare, consultare la documentazione e impostare la Partner API, tutti elencati sotto.
Throughput di invio fisso per un numero Coexistence, stabilito da Meta. Non può essere aumentato, né da noi né da te.
Per quanto tempo la risposta di un cliente mantiene aperta la sessione. Al di fuori di questo periodo, puoi inviare solo un template approvato.
Il server è remoto, quindi nulla viene eseguito sul tuo computer e nessuna sessione viene conservata in alcun luogo.
Domande frequenti
Il numero del mio cliente può essere bloccato a causa di questo sistema?
No. Questa è la Cloud API ufficiale di Meta, raggiunta tramite la funzione Coexistence di Meta. Il rischio di blocco di cui si parla deriva da gateway non ufficiali che accedono come dispositivo collegato, un meccanismo completamente diverso.
Con quali assistenti funziona il connettore?
Con qualsiasi strumento che supporti MCP tramite HTTP con OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex oggi. È un unico endpoint remoto, quindi nulla viene eseguito sul tuo computer.
Le mie conversazioni passano dai vostri server?
Non per impostazione predefinita. I messaggi in arrivo passano da Meta direttamente al webhook che indichi, e non conserviamo alcun contenuto delle conversazioni. Conserviamo solo l'account, lo stato del numero e le credenziali necessari per gestire e monitorare la connessione.
Posso usare un connettore per diversi clienti?
Sì. Un account può contenere tutti i numeri che ti servono, ciascuno fatturato come una connessione separata, e il connettore li elenca tutti. Non ci sono restrizioni sull'uso per le aziende che servi.
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuita3 giorni gratuiti. Non viene addebitato nulla fino alla fine della prova.