WhatsApp Coexistence: usa l'API senza rinunciare a WhatsApp Business

Quale problema risolve

Prima della coesistenza (Coexistence), passare un numero all'API significava toglierlo dall'app: il team smetteva di rispondere dal telefono e bisognava migrare tutto su un sistema nuovo. Con Coexistence non devi scegliere: lo stesso numero, lo stesso account e le stesse conversazioni, nell'app e nel tuo sistema contemporaneamente.

Serve quando il numero esiste già, ci sono già clienti che scrivono e qualcuno risponde dal cellulare, e vuoi aggiungere automazione, un CRM o un bot senza interrompere quel servizio.

Come si collega

L'onboarding avviene con Embedded Signup, la finestra ufficiale di Meta. Il titolare del numero accede con Facebook, sceglie o crea il suo portafoglio aziendale e, alla fine, scansiona un codice QR dall'app WhatsApp Business (Impostazioni → Dispositivi collegati). Serve un secondo schermo: il codice appare sul computer e si scansiona con il telefono.

Puoi fare l'onboarding tu stesso dal pannello, oppure mandare al tuo cliente un link di onboarding con il tuo marchio, così lo fa lui senza darti le sue credenziali di Meta.

Passo per passo e cosa di solito lo blocca: Mentre ti colleghi · dove si scansiona il QR.

Cosa vede il tuo sistema

• I messaggi in arrivo (message.received), con un solo webhook per tutti i tuoi numeri.
• Ciò che il tuo team scrive dal telefono (message.echo): il contenuto di quei messaggi arriva al tuo sistema e non consuma la quota del tuo piano.
• Lo stato di ogni invio (message.status: inviato, consegnato, letto, non riuscito).
• Un riepilogo della cronologia che Meta condivide al collegamento (history.synced).

Tutti gli eventi e il loro formato: Tipi di evento · Ricevere il webhook.

Limiti della coesistenza (secondo Meta)

Sono di Meta, non di WAIA Connect, e valgono con qualsiasi fornitore. La documentazione ufficiale di Meta dice che, dopo aver collegato un numero in coesistenza:

• L'app deve essere WhatsApp Business 2.24.17 o successiva.
• Le liste broadcast e i messaggi «visualizza una volta» vengono disattivati; gruppi, messaggi effimeri, posizione in tempo reale e chiamate tramite l'API non sono supportati.
• Si può sincronizzare la cronologia degli ultimi 6 mesi, entro 24 ore dall'onboarding.
• Il numero ha un limite di 20 messaggi al secondo.
• I dispositivi collegati vengono scollegati al collegamento e bisogna ricollegarli; la documentazione indica eccezioni per piattaforma.
• Se il telefono principale non viene usato per circa 14 giorni, Meta scollega il numero.

I messaggi inviati dall'app restano gratuiti; quelli inviati tramite l'API hanno i prezzi abituali di Meta.

Quanto costa

Una tariffa fissa per numero collegato, senza limite di messaggi e con 14 giorni di prova:

• Starter — US$ 12 al mese, 1 numero
• Studio — US$ 25 al mese, 5 numeri
• Agencia — US$ 45 al mese, 12 numeri
• Escala — US$ 99 al mese, 30 numeri, più US$ 3 per ogni numero extra

Meta addebita a parte i propri messaggi, sulla carta del tuo account Meta; WAIA Connect non aggiunge ricarichi. Dettagli nell'Aiuto.

Domande frequenti

Posso continuare a rispondere dal cellulare dopo aver collegato il numero all'API?

Sì. Con Coexistence l'app WhatsApp Business continua a funzionare sul telefono, e ciò che si scrive lì arriva al tuo sistema come evento message.echo.

Perdo le mie chat quando mi collego?

Non vengono cancellate dall'app. Meta permette all'azienda di condividere con l'API la cronologia degli ultimi 6 mesi entro 24 ore dall'onboarding, se l'azienda lo accetta.

Il mio cliente deve darmi il suo accesso a Facebook?

No. Gli mandi un link di onboarding con il tuo marchio, lui fa l'onboarding nella finestra di Meta con la sua sessione, e il numero resta collegato al tuo account WAIA Connect.

Cosa non funziona in coesistenza?

Secondo Meta: liste broadcast, messaggi «visualizza una volta», gruppi, messaggi effimeri, posizione in tempo reale e chiamate tramite l'API. Il numero ha un limite di 20 messaggi al secondo.

Fa per me se non ho intenzione di programmare nulla?

Probabilmente no: WAIA Connect collega WhatsApp a un tuo sistema. Se vuoi una casella per rispondere con il tuo team e un assistente di IA, senza programmare, quello è WAIA.

Fonti

Consultate il 28/09/2026.

• Meta — Onboarding WhatsApp Business app users (Coexistence)

Per continuare

• Cloud API o Coexistence: quale scegliere
• Embedded Signup: l'onboarding ufficiale di Meta
• Il limite di 300 nuove chat dell'app
• Documentazione dell'API
• Aiuto
• Informativa sulla privacy