WhatsApp Embedded Signup per i tuoi clienti: la tua app Tech Provider o una pagina ospitata
Un SaaS può collegare i numeri WhatsApp Business app dei suoi clienti alla Cloud API tramite Embedded Signup di Meta in due modi. Può diventare esso stesso Meta Tech Provider, il che comporta la verifica dell'azienda, una App Review con due video e una propria build di Embedded Signup, oppure inviare i clienti a una pagina Embedded Signup ospitata da un provider che lo è già, e ricevere la connessione completata.
easyCoexistence esegue Embedded Signup di Meta con Coexistence su una pagina ospitata che riporta il tuo nome, così i tuoi clienti collegano i loro numeri senza che tu diventi Tech Provider.
Nuovi clienti aziendali che un Tech Provider può collegare in ogni periodo mobile di 7 giorni: 10 per impostazione predefinita, 200 dopo verifica e revisione.
Registrazioni dello schermo richieste da App Review a un Tech Provider: un messaggio inviato e ricevuto e la creazione di un template.
La durata media dichiarata da Meta per la App Review di un'app WhatsApp.
La versione più vecchia dell'app WhatsApp Business che un cliente può collegare tramite Coexistence.
Per quanto tempo il codice restituito da Embedded Signup resta valido perché il server lo scambi con il token dell'azienda del cliente.
Quali sono i due modi per attivare i numeri dei clienti?
Entrambi usano Embedded Signup di Meta con Coexistence e finiscono nello stesso punto: il numero del cliente sulla Cloud API, ancora funzionante nell'app WhatsApp Business, e il tuo backend che conserva il token dell'azienda del cliente. La differenza sta in chi si fa carico dei requisiti di Meta e del codice attorno al popup.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
Cosa richiede Meta per diventare Tech Provider?
Meta elenca i passaggi nella guida Become a Tech Provider, che la dashboard dell'app apre sotto l'onboarding Tech Provider del caso d'uso WhatsApp:
- Un'app Meta con il caso d'uso WhatsApp, collegata al tuo Business Portfolio.
- Verifica dell'azienda, che viene per prima: Meta avvia la App Review solo per un'azienda verificata.
- Impostazioni dell'app come icona, informativa sulla privacy e categoria.
- Accesso avanzato a
whatsapp_business_messagingewhatsapp_business_management, concesso tramite App Review con una spiegazione scritta e una registrazione dello schermo per ciascuno. - Due registrazioni in tutto: un messaggio inviato dalla tua app e ricevuto in WhatsApp, e la tua app che crea un template di messaggio.
Cosa costruisci una volta approvato?
L'onboarding vero e proprio, che le guide di Embedded Signup di Meta descrivono passo passo:
- Il flusso sul tuo sito, tramite Facebook Login for Business e l'SDK JavaScript di Meta, su domini HTTPS che consenti nell'app.
- Coexistence attivata nella configurazione del flusso, con il logging della sessione, che Meta richiede per questa funzione.
- Una chiamata al server che scambia il codice restituito con il token dell'azienda del cliente entro 30 secondi.
- Webhook: la tua app iscritta all'account di ciascun cliente, con i campi
account_update, history,smb_app_state_syncesmb_message_echoes. - La sincronizzazione di contatti e storico entro 24 ore dall'onboarding; dopo, il cliente deve disattivare il collegamento ed eseguire di nuovo il flusso.
Cosa fa la pagina ospitata?
Tutta la parte del popup. easyCoexistence esegue Embedded Signup con Coexistence tramite la propria app Meta come Tech Provider, su una pagina su easycoexistence.com che mostra il tuo nome. Lo scambio del token, l'iscrizione ai webhook e la richiesta dello storico avvengono lì, e il tuo backend riceve un id di connessione. Con un webhook_url nella sessione, Meta consegna i messaggi del numero direttamente al tuo server, insieme all'importazione una tantum dei contatti e, quando il cliente la condivide, fino a 180 giorni di chat. Il tuo codice poi chiama direttamente la Graph API di Meta con il token del cliente, mentre easyCoexistence controlla il numero e invia eventi firmati quando cambia.
Cosa vede il tuo cliente?
Una pagina con il tuo nome e un solo pulsante Connect. Prima che si apra il popup di Meta, una checklist chiede al cliente di confermare cinque cose: un'app WhatsApp Business aggiornata, un numero in uso reale da almeno 7 giorni, nessun altro provider API o strumento di automazione sul numero, nessuna app non ufficiale e il telefono a portata di mano con un accesso a Facebook. Non viene chiesto né un account, né un'e-mail, né una carta.
Cosa succede dentro il popup di Meta?
Il flusso di Meta fa accedere il cliente con Facebook, gli chiede di autorizzare l'app e di inserire il numero, e mostra il profilo dell'app WhatsApp Business del numero perché lo confermi. Sceglie o crea un Business Portfolio, poi scansiona un codice QR dall'interno dell'app WhatsApp Business; Meta invia anche al numero un messaggio WhatsApp con un link al codice. Nell'app tocca Connect e sceglie se condividere lo storico delle chat. Infine arrivano il nome dell'account, un fuso orario e i termini di Meta. L'ordine può cambiare mentre Meta introduce il suo flusso con il numero di telefono per primo.
Quale nome mostra il popup di Meta?
Il nome dell'app che chiede l'accesso. Sulla pagina ospitata è easyCoexistence, e non può essere rinominato, mentre la pagina intorno al popup mostra il tuo nome preso da partner_name. Un'app Tech Provider propria mostra invece il nome della tua app, al prezzo della verifica, della revisione e della costruzione descritte sopra.
Cos'è la regola dei 14 giorni?
Meta disconnette un numero Coexistence quando il telefono che ospita l'app WhatsApp Business è rimasto inattivo per circa 14 giorni, e riporta il motivo come PRIMARY_INACTIVITY. Il cliente si riconnette rifacendo il flusso con lo stesso numero. Tramite la pagina ospitata, easyCoexistence controlla ogni numero e invia al tuo URL di eventi connection.disconnected con quel motivo, così un nuovo link di connessione per il cliente può ripristinare il numero.
Errori comuni
- Costruire su Embedded Signup v2 o v3. Meta le ha dismesse il 15 ottobre 2026 e le richieste verso di esse vengono servite come v4.
- Richiedere permessi che l'app non usa. Meta indica i permessi non necessari come motivo comune di rifiuto di una App Review.
- Registrare un solo video per entrambi i permessi. Meta vuole una registrazione dello schermo e una spiegazione scritta separate per ciascuno, e può respingere un video che ne mostra diversi.
- Chiedere ai clienti di collegarsi dal telefono che ospita il numero. Il popup di Meta si apre lì in una nuova scheda, e lo stesso telefono deve scansionare il codice QR, quindi un computer è più semplice.
Il tuo backend riceve il token di ciascun cliente, Meta consegna i messaggi direttamente al tuo webhook e le disconnessioni ti arrivano come eventi firmati. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che ne aggiungi. I primi 3 giorni sono gratuiti.
Domande frequenti
Devo essere un Meta Tech Provider per attivare i numeri WhatsApp dei miei clienti?
Solo per eseguire Embedded Signup dalla tua app Meta. Inviare i clienti a una pagina ospitata gestita da un Tech Provider collega i loro numeri senza la tua verifica dell'azienda né una tua App Review.
Quanto dura la App Review di Meta per un'app WhatsApp?
Meta indica una media di circa 24 ore. La verifica dell'azienda deve essere completata prima che la revisione possa iniziare, e ogni invio respinto aggiunge un altro giro.
Il mio cliente continua a usare l'app WhatsApp Business?
Sì. L'app continua a funzionare sul suo telefono accanto all'API, e i messaggi vengono replicati tra le due. Alcune funzioni dell'app cambiano: le liste di broadcast diventano di sola lettura, e i messaggi temporanei e a visualizzazione singola vengono disattivati.
Chi paga Meta per i messaggi?
Il cliente. Meta addebita i messaggi inviati tramite l'API sull'account WhatsApp Business del cliente, con un metodo di pagamento che aggiunge lì, mentre i messaggi inviati dall'app WhatsApp Business restano gratuiti.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il