AccediInizia la prova gratuita
Meta Tech Provider

API WhatsApp per agenti AI: accesso ufficiale in pochi minuti, senza diventare Tech Provider

Un agente AI ottiene l'accesso ufficiale a WhatsApp tramite la Cloud API di Meta, e un numero che resta nell'app WhatsApp Business vi entra tramite un Tech Provider o un Solution Partner. Puoi diventarlo tu, con la verifica dell'azienda, i video per la App Review e una build di Embedded Signup, oppure collegarti tramite un provider che lo è già: il numero si connette in pochi minuti e l'agente riceve gli strumenti MCP o le credenziali API.

easyCoexistence è un Tech Provider indipendente di Meta: collega un numero WhatsApp Business alla Cloud API tramite Coexistence in pochi minuti, così il tuo agente ottiene l'accesso ufficiale mentre l'azienda mantiene l'app.

Tech Provider

Ciò che Meta richiede a chi attiva un numero che resta nell'app WhatsApp Business: lo stato di Tech Provider o di Solution Partner.

2 videos

La App Review chiede un video di un messaggio inviato dalla tua app e uno della tua app che crea un template.

Advanced access

Ciò che la App Review concede a whatsapp_business_messaging e whatsapp_business_management, entrambi necessari per diventare Tech Provider.

October 15, 2026

Quando Meta ha reso obsoleti Embedded Signup v2 e v3, chiedendo alle integrazioni di passare alla v4.

20 msg/s

Il throughput fisso di un numero in uso sia con l'app WhatsApp Business sia con la Cloud API.

1 hour

Per quanto tempo resta valido un link di connessione ospitato quando una piattaforma attiva il numero di un cliente tramite la Partner API.

Di cosa ha bisogno un agente AI per usare WhatsApp in modo ufficiale?

Quattro cose dalla Cloud API di Meta. Un ID del numero di telefono e un access token con il permesso whatsapp_business_messaging, così l'agente può chiamare l'endpoint dei messaggi. Un endpoint webhook a cui Meta consegna i messaggi in arrivo, più, su un numero condiviso con l'app, smb_message_echoes per le risposte che una persona scrive dal telefono. Template approvati, perché un messaggio di testo libero raggiunge solo chi ha scritto negli ultimi 24 ore. E un modo per sapere quando la connessione si interrompe, perché l'app sul telefono continua a funzionare anche quando il lato API smette.

La scorciatoia che la gente trova per prima è l'automazione di WhatsApp Web, che accede come dispositivo collegato. Viola i termini di WhatsApp e mette il numero a rischio di blocco, qualunque cosa faccia l'agente sopra di essa.

Cosa comporta il percorso Tech Provider?

La sequenza di Meta stessa, in quest'ordine. Ogni passaggio è gratuito e nessuno si può comprare più in fretta: le revisioni seguono il calendario di Meta, che non pubblica alcuna tempistica, quindi metti in conto settimane invece di giorni prima che il numero del primo cliente si connetta. Dopodiché il backend deve restare in funzione: lo scambio di token dopo ogni registrazione, un ricevitore di webhook, l'instradamento per numero e il monitoraggio delle disconnessioni, come la regola di inattività di 14 giorni di Meta.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Qual è la via più breve?

Collegare il numero tramite un provider che ha già superato questo processo. Con easyCoexistence, l'azienda esegue Embedded Signup di Meta e scansiona un codice con l'app WhatsApp Business, operazione che richiede circa due minuti; il numero entra nella Cloud API nel Business Portfolio dell'azienda stessa, mentre l'app continua a funzionare. L'agente ottiene quindi l'accesso nella forma che gli serve: strumenti MCP per un assistente come ChatGPT, Claude, Claude Code o Codex, oppure le credenziali e i webhook del numero per il codice che esegui tu.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Come ottiene l'agente le credenziali del numero?

Tramite get_api_credentials, oppure dalla pagina del numero nella dashboard. Lo strumento restituisce l'URL base della Graph API, il WhatsApp Business Account ID, l'ID del numero di telefono, l'endpoint di invio e, quando esiste, l'access token dell'azienda, limitato alle sue risorse WhatsApp. Se non è stato emesso alcun client token, il token torna null con una nota che riconnettere il numero dalla dashboard ne emette uno, senza sostituire un token che funziona. Non c'è alcun app secret da recuperare, perché Meta firma i webhook con l'app secret di easyCoexistence, che non viene mai condiviso. Lo strumento richiede un piano attivo, perché il token può inviare.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Come arrivano i messaggi in entrata all'agente?

Ogni numero ha due modalità, da cambiare con set_inbound_mode o nella pagina del numero. Diretta al tuo server: set_webhook_destination punta Meta direttamente al tuo endpoint HTTPS, che deve rispondere all'handshake GET di Meta, e easyCoexistence non vede mai i messaggi, quindi le automazioni sono disattivate. Poiché Meta firma quelle consegne con la nostra app secret, inserisci un segreto casuale e lungo nel percorso dell'URL e rifiuta le richieste che ne sono prive.

Automazioni attive: Meta consegna a easyCoexistence, le automazioni possono rispondere e un Forward URL opzionale riceve il payload originale di Meta sotto "value", firmato con X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 di "<t>.<body>"> usando un segreto mostrato una sola volta. Lo step Call my webhook di un'automazione consegna anche il messaggio e gli ultimi 10 messaggi della chat al tuo agente, e invia la sua risposta quando la tua risposta è {"reply": "..."} entro 20 secondi.

Quali limiti deve rispettare l'agente?

Quelli di Meta, uguali attraverso qualsiasi provider. Un agente che li conosce in anticipo evita i guasti che sembrano bug:

  • 20 messaggi al secondo per numero, fissati da Meta per i numeri condivisi con l'app WhatsApp Business.
  • Messaggi di testo libero solo entro 24 ore dall'ultimo messaggio del cliente; dopo, un template approvato.
  • I template partono solo tramite API, perché l'app su un numero Coexistence non può inviarli.
  • Le risposte che una persona scrive nell'app arrivano come smb_message_echoes; metti in pausa l'agente su quella chat, altrimenti il cliente riceve due risposte.
  • Le chat di gruppo non sono sincronizzate con l'API, quindi l'agente lavora nelle chat uno a uno.
  • Contatti e fino a 6 mesi di chat uno a uno vengono importati una sola volta, solo se una destinazione webhook diretta viene salvata entro 24 ore dalla connessione; un numero con automazioni attive non riceve l'importazione.
  • Le chiamate vocali e video continuano a funzionare nell'app, ma la Cloud API non gestisce le chiamate su un numero Coexistence, quindi l'agente lavora in testo.

Una piattaforma può collegare così i numeri dei propri clienti?

Sì, tramite la Partner API, che è il modo in cui una SaaS o un'agenzia attiva i propri clienti senza avere uno status di Tech Provider proprio. Crea la chiave con create_api_key (inizia con ec_live_ ed è mostrata una sola volta), poi chiama POST /api/v1/connect-sessions dal tuo backend, oppure create_connect_link dall'assistente, per ottenere un link ospitato valido per 1 ora. Il cliente esegue lì il popup di Meta e la scansione del QR e torna al tuo redirect_url con un connection_id. GET /api/v1/connections/:id?credentials=1 restituisce poi il token del cliente, e gli eventi di stato come connection.disconnected arrivano firmati con X-EC-Signature. Ogni numero viene fatturato al tuo account con le stesse fasce per numero.

Errori comuni

  • Validare X-Hub-Signature-256 su una destinazione diretta. Meta firma con l'app secret di easyCoexistence, che non viene mai condivisa, quindi le consegne autentiche non superano il controllo; affidati a un segreto casuale e lungo nell'URL, oppure usa l'inoltro con X-EC-Signature.
  • Ricevere con il nodo WhatsApp Trigger di n8n. Si aspetta la tua app Meta; usa invece il nodo generico Webhook con un segreto nel suo URL.
  • Ignorare smb_message_echoes. L'agente risponde allora sopra una persona che ha già risposto dal telefono, e il cliente legge due risposte.
  • Salvare la destinazione webhook diretta giorni dopo la connessione, o lasciare il numero con le automazioni attive. L'importazione unica di contatti e di fino a 6 mesi di chat da parte di Meta richiede una destinazione diretta salvata entro 24 ore dalla connessione.
Farlo con EasyCoexistence

L'agente lavora tramite più di 30 strumenti MCP o tramite le credenziali e i webhook di ogni numero, e ogni numero è monitorato 24/7 con avvisi. Da US$ 9 fino a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni gratuiti.

Domande frequenti

Mi serve una mia app Meta?

No. Il numero viene attivato tramite l'app Meta di easyCoexistence e resta nel Business Portfolio e nel WhatsApp Business Account dell'azienda. Il tuo codice invia con l'access token dell'azienda ottenuto da get_api_credentials, quindi nessuna app tua è coinvolta, a meno che tu non ne costruisca una in seguito.

L'agente e il team possono usare il numero allo stesso tempo?

Sì. Meta replica i messaggi tra la Cloud API e l'app WhatsApp Business, quindi ciò che invia l'agente compare nella chat dell'app sul telefono, e ciò che il team scrive nell'app arriva al tuo sistema come smb_message_echoes.

Quali framework di agenti funzionano con questo?

Qualsiasi client che parli MCP over HTTP con OAuth, come ChatGPT, Claude, Claude Code, Codex e Cursor, e qualsiasi codice che chiami la Graph API di Meta: Node.js, Python, n8n, LangChain, l'OpenAI Agents SDK o il Vercel AI SDK. L'API sottostante è quella di Meta, quindi nell'agente non c'è nulla di proprietario.

Un assistente AI generico è consentito su WhatsApp?

La sezione 4.7 dei Business Solution Terms di Meta vieta ai fornitori di assistenti AI generici di offrirli sulla WhatsApp Business Platform quando l'AI è la funzione principale, secondo la valutazione di Meta, in vigore dal 15 gennaio 2026. Un'azienda che usa l'AI per i propri clienti, per supporto, vendite o prenotazioni, non è il bersaglio, e le autorità di regolamentazione in UE e Brasile hanno ordinato a Meta di sospendere o ritirare la norma per gli assistenti concorrenti.

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 gratuita

Verificato il