Configurazione di un account WhatsApp Business API: registrazione, verifica e checklist del numero
TL;DRLa configurazione di un account WhatsApp Business API è più semplice se la consideri un lancio operativo, non un modulo da completare. Account, verifica aziendale, WhatsApp Business Account, numero, template, consensi e prima automazione devono funzionare insieme.
Per un team ecommerce, l'obiettivo non è soltanto far comparire un messaggio di prova. È lanciare un numero aziendale affidabile che invii il messaggio Shopify corretto, si fermi quando deve, indirizzi le risposte e produca un risultato misurabile.
Questa checklist accompagna dalla preparazione dell'account al primo flusso testato senza trasformare la procedura in una guida riservata agli sviluppatori.
Prima di tutto, verifica che ti serva un account API
L'app WhatsApp Business e la Piattaforma WhatsApp Business risolvono esigenze diverse. L'app è utile per conversazioni manuali individuali, un profilo semplice, risposte rapide e un piccolo team. La piattaforma, spesso chiamata WhatsApp Business API, è pensata per messaggistica programmabile, integrazioni, template, automazioni e invii su larga scala.
Scegli una configurazione API quando il negozio richiede una o più di queste funzioni:
Messaggi attivati da Shopify, come recupero checkout abbandonato, conferma contrassegno, aggiornamenti ordine, richieste di recensione o riattivazione.
Messaggi avviati dall'azienda tramite template approvati.
Un flusso condiviso per risposte e contesto cliente.
Eventi di consegna, controlli delle automazioni o report sui ricavi.
Un provider, una piattaforma o un'app collegati alla stessa identità WhatsApp aziendale.
Se ti serve soltanto un link alla chat e una persona risponderà manualmente a ogni conversazione, l'app Business può bastare. Se invece gli eventi del negozio devono attivare messaggi coerenti, pianifica l'account API.
Configurazione WhatsApp Business API in sintesi
La procedura comprende cinque fasi pratiche.
| Fase | Cosa preparare o completare | Verifica finale |
|---|---|---|
| Preparazione | Responsabile, dati aziendali, sito, caso d'uso e piano del numero | Una persona guida il lavoro e tutti i dati sono coerenti |
| Registrazione | Portfolio Meta, WABA, profilo e collegamento a provider o app | WABA e numero restano sotto l'azienda corretta |
| Verifica | Identità aziendale, proprietà del numero, nome visualizzato e verifica in due passaggi | L'account può superare in sicurezza la fase di test |
| Test | Template, consenso, contatto di prova, evento Shopify, percorso risposta e regola di arresto | Un test completo riesce senza interventi manuali |
| Lancio | Primo flusso, pubblico, tempistiche, fallback e metrica | Il team riconosce successo e fallimento |
Non iniziare creando risorse negli account Meta di più dipendenti. Decidi prima la proprietà: recuperi e cambi di fornitore diventano difficili se l'azienda non controlla portfolio, WABA, numero e accesso amministrativo.
Cosa preparare prima della registrazione
Raccogli questi elementi prima di aprire la procedura guidata.
| Requisito | Cosa avere pronto | Errore comune |
|---|---|---|
| Accesso Meta | Un titolare o dipendente reale con controllo completo del portfolio corretto | Lasciare un dipendente dell'agenzia come unico amministratore |
| Identità legale | Ragione sociale, indirizzo, telefono e documenti | Inserire il brand quando i registri riportano un'altra entità |
| Presenza pubblica | Sito funzionante con brand, contatti e, se possibile, email sul dominio | Presentare un sito provvisorio o dati contrastanti |
| Identità WhatsApp | Nome visualizzato, categoria, descrizione, logo, sito e contatto assistenza | Scegliere un nome non chiaramente legato al brand |
| Percorso del numero | Numero nuovo, migrazione o coesistenza idonea | Presumere che ogni numero attivo sia riutilizzabile senza modifiche |
| Primo caso d'uso | Un flusso con pubblico, trigger, tempi, testo, responsabile e metrica | Richiedere l'API senza sapere cosa partirà per primo |
| Consenso | Punto di raccolta opt-in e registrazione opt-out | Considerare ogni telefono al checkout come consenso marketing |
| Modalità di setup | Cloud API diretta, piattaforma ampia o app Shopify | Scegliere il provider prima di definire chi gestisce i flussi |
Mantieni nome e indirizzo coerenti tra sito, portfolio Meta e documenti. Differenze minime, come un vecchio indirizzo o un suffisso legale mancante, possono creare cicli di revisione evitabili.
Comprendere la struttura dell'account
Durante la registrazione ricorrono tre elementi:
Il portfolio aziendale Meta possiede e gestisce risorse e autorizzazioni.
Il WhatsApp Business Account, abbreviato WABA, contiene numeri, template, Flows e risorse correlate.
Il numero di telefono aziendale è il mittente visibile al cliente registrato nella WABA.
Il provider o l'app Shopify può guidare il setup con la registrazione incorporata di Meta, ma questa assistenza non deve nascondere la proprietà. Verifica quale azienda possiede la WABA, chi ha accesso amministrativo e cosa succede a numero e template se cambi software.
Il provider è il livello operativo; identità e numero devono restare risorse aziendali durevoli.
Passaggio 1: scegli setup diretto, piattaforma o app
Il percorso determina chi svolgerà il lavoro tecnico successivo.
| Percorso | Ideale per | Il tuo team controlla ancora |
|---|---|---|
| Cloud API diretta | Team tecnici che costruiscono infrastruttura personalizzata | App, token, webhook, retry, template, sincronizzazione, sicurezza e report |
| Piattaforma WhatsApp ampia | Team con marketing, vendite, supporto, campagne e inbox | Configurazione, processi agenti, governance contatti, componenti e flussi |
| App di automazione Shopify | Negozi focalizzati su flussi retention pronti al lancio | Flusso, consenso, approvazione, tempi, risposte e performance |
L'accesso diretto è valido se servono infrastruttura personalizzata e sviluppatori. Una piattaforma ampia funziona quando WhatsApp serve più reparti. Un'app Shopify è spesso più lineare quando contano soprattutto eventi del negozio e retention.
Per il confronto completo, leggi Soluzione WhatsApp Business API: BSP, piattaforma o app di automazione?.
Passaggio 2: crea o seleziona il portfolio Meta corretto
Usa il portfolio destinato a possedere le risorse WhatsApp nel lungo periodo. Assegna controllo completo ad almeno due amministratori interni fidati.
Prima di continuare, verifica:
Ragione sociale, indirizzo, sito e contatti sono corretti.
Il sito collega chiaramente brand pubblico e azienda.
Solo persone e partner necessari hanno accesso.
Gli amministratori usano l'autenticazione a due fattori.
Chi conduce il setup può completare i controlli di sicurezza.
Se collabora un'agenzia o un provider, concedi accesso come partner o alla singola risorsa invece di trasferire l'identità aziendale a un account esterno.
Passaggio 3: crea o seleziona WABA e profilo aziendale
La registrazione incorporata o diretta richiederà di creare o collegare una WABA. Scegli un nome chiaro per il team, poi completa il profilo.
Prepara un nome visualizzato già associato dai clienti al negozio. Deve avere un rapporto evidente con il brand sul sito e nei registri. Prepara inoltre categoria, descrizione, sito, email di supporto e logo.
Non confondere tre verifiche separate:
La verifica aziendale conferma che il portfolio appartiene a un'organizzazione legittima.
La verifica telefonica conferma il controllo del numero via SMS o chiamata.
Meta Verified o badge ufficiale è un programma separato di fiducia o abbonamento, non il setup API di base.
Gestiscili come processi distinti. Un badge non sostituisce proprietà, registrazione, conformità alle policy o automazione funzionante.
Passaggio 4: completa la verifica aziendale
Meta può chiedere di confermare organizzazione legale, indirizzo, telefono, dominio o legame con l'azienda. Il metodo varia per account e mercato.
Prepara documenti aggiornati e leggibili che corrispondano ai dati inseriti: per esempio certificato di registrazione, documento fiscale, licenza, documento bancario o bolletta. Invia soltanto ciò che richiede il flusso attuale.
Checklist:
Fai coincidere il nome legale, carattere per carattere quando possibile.
Usa l'indirizzo registrato corrente.
Verifica che i documenti siano completi, leggibili, validi e non alterati.
Usa email o dominio controllati dall'azienda quando disponibili.
Registra chi invia la verifica e dove arriveranno le risposte.
Non inviare varianti ripetute mentre una revisione è attiva.
Alcune funzioni di prova possono comparire prima della verifica completa, ma un piano di produzione non dovrebbe dipendere da uno stato temporaneo o limitato. Completa presto la verifica per evitare che diventi l'ultimo ostacolo.
Passaggio 5: scegli con attenzione il percorso del numero
Il numero è la decisione con il maggior rischio di rilavorazione.
| Percorso | Quando è adatto | Cosa verificare prima |
|---|---|---|
| Numero nuovo dedicato | Vuoi la configurazione API più pulita | Riceve SMS o chiamate e non è legato a un account indesiderato |
| Migrazione del numero | I clienti lo conoscono e serve continuità | Requisiti, interruzioni, cronologia chat, backup e passaggi provider |
| Coesistenza idonea | Vuoi mantenere l'app Business aggiungendo la piattaforma | Disponibilità per account, regione, provider e versione app |
Non pubblicare un numero nuovo prima che sia stabile, ma non rimandare la decisione sulla migrazione al giorno del setup. Se usa IVR, fisso, inoltro o servizio virtuale, verifica che il codice raggiunga una persona.
Prima di richiedere il codice:
Conferma numero internazionale e prefisso.
Sospendi i sistemi che potrebbero intercettare SMS o chiamata.
Assicurati che qualcuno possa rispondere subito.
Documenta se il vecchio account va migrato, rimosso o mantenuto in coesistenza.
Decidi come gestire le risposte dopo il passaggio.
Lascia che il flusso corrente di Meta e provider determini l'idoneità. Non affidarti a guide vecchie che impongono di eliminare ogni account attivo e non presumere che tutti possano coesistere.
Passaggio 6: verifica la proprietà e proteggi la registrazione
Meta verifica il numero con un codice SMS o vocale. Le implementazioni dirette registrano anche il numero e impostano un PIN a sei cifre. Anche se il provider gestisce le chiamate tecniche, l'azienda deve conservare PIN e recupero in modo sicuro.
Dopo la verifica:
Salva il PIN nel gestore password aziendale.
Registra ID WABA e ID del numero se disponibili.
Verifica che almeno due amministratori interni accedano alle impostazioni.
Rimuovi gli accessi temporanei non più necessari.
Annota eventuali scadenze indicate per completare la registrazione.
Non inserire mai token, codici o PIN in documenti di progetto o chat condivise.
Passaggio 7: prepara template, opt-in e gestione delle risposte
La registrazione non equivale alla prontezza al lancio. I messaggi avviati dall'azienda richiedono template e i clienti devono aver accettato la comunicazione su WhatsApp.
| Controllo | Esempio checkout abbandonato | Perché conta |
|---|---|---|
| Trigger | Checkout iniziato senza ordine | Esclude contatti non pertinenti |
| Pubblico | Numero valido e opt-in adeguato | Protegge fiducia e qualità |
| Tempistica | Primo promemoria dopo un intervallo intenzionale | Non interrompe un acquisto attivo |
| Template | Promemoria chiaro con link al checkout | Chiarisce intento e facilita l'approvazione |
| Regola di arresto | Stop dopo acquisto, opt-out, numero invalido o soppressione | Evita messaggi indesiderati |
| Responsabile risposta | Persona o coda di supporto definita | Evita conversazioni ignorate |
| Metrica | Checkout e ricavi recuperati, risposte e opt-out | Misura il valore del flusso |
Mantieni il primo template focalizzato. Non unire aggiornamento, promozione, sondaggio e upsell. Un motivo e un'azione sono più facili da approvare, gestire e migliorare.
Passaggio 8: esegui un test end-to-end
Non considerare pronto l'account dopo un esempio API o un messaggio di prova del provider. Testa il percorso reale.
Crea checkout o ordine controllato con un numero consentito.
Conferma che l'evento Shopify corretto raggiunga l'automazione.
Controlla che il cliente entri nel pubblico giusto.
Verifica intervallo e variabili del template.
Ricevi il messaggio da numero e profilo corretti.
Apri i link e verifica la destinazione.
Rispondi e conferma che l'incaricato veda la conversazione.
Completa l'acquisto o attiva la condizione di arresto.
Conferma che il messaggio successivo non parta.
Controlla consegne, errori, risposte e conversioni.
Questo dimostra che account, numero, template, integrazione, esperienza, passaggio al team e misurazione funzionano come un sistema.
Errori comuni e loro significato
| Sintomo | Causa probabile | Controllo successivo |
|---|---|---|
| Verifica bloccata | Dati e prove non coincidono | Confronta nome, indirizzo, sito e documenti |
| Nome visualizzato rifiutato | Legame con il brand poco chiaro o regole violate | Allinea nome, sito, profilo e identità |
| Codice non ricevuto | Numero errato, IVR, instradamento o vecchio account irrisolto | Controlla prefisso, SMS/voce, migrazione e coesistenza |
| Test riuscito, automazione no | API collegata ma trigger, pubblico o mappatura incompleti | Segui un evento Shopify fino alla decisione di invio |
| Risposte invisibili | Mancano inbox, webhook, notifica o assegnazione | Testa il percorso di risposta |
| Messaggi dopo l'acquisto | Manca stop o riconciliazione evento | Testa la soppressione sull'ordine reale |
| Proprietà poco chiara | Risorse sotto dipendente, agenzia o provider | Controlla portfolio, WABA, numero e admin |
Correggi il livello esatto che non funziona. Ricreare la WABA o cambiare provider raramente è la prima mossa.
Lancia il primo flusso Shopify
Inizia con un solo percorso cliente, non con un calendario completo.
| Primo flusso | Trigger | Metrica principale |
|---|---|---|
| Checkout abbandonato | Checkout incompleto dopo l'intervallo scelto | Checkout e ricavi recuperati |
| Conferma contrassegno | Nuovo ordine COD | Confermati, annullati e senza risposta |
| Aggiornamento ordine | Cambia stato ordine o evasione | Consegne e riduzione ticket |
| Richiesta recensione | Consegna confermata e intervallo trascorso | Clic e recensioni completate |
Per ogni flusso annota trigger, tempistica, segmento, messaggio, fallback e metrica. Assegna una persona a risposte ed eccezioni nei primi giorni. Controlla errori e opt-out prima di aumentare il volume.
Dove si inserisce Retentionly
Retentionly è pensato per team Shopify e D2C che vogliono usare l'account WhatsApp per flussi di retention senza costruire il livello operativo sopra una API grezza.
Il setup stabilisce identità e mittente. Retentionly collega questa base a recupero checkout, conferma COD, aggiornamenti, recensioni, winback, riordino, benvenuto e upsell post-acquisto.
È adatto quando la domanda principale non è «Come manteniamo l'infrastruttura API?», ma «Come lanciamo e misuriamo il flusso Shopify giusto?».
Checklist finale
Conferma che l'app Business non basti più.
Nomina un responsabile interno e un amministratore di riserva.
Correggi dati e accessi nel portfolio Meta.
Prepara documenti, sito, email e brand coerenti.
Scegli API diretta, piattaforma o app Shopify.
Crea o seleziona la WABA sotto l'azienda corretta.
Prepara un nome valido e completa il profilo.
Completa la verifica senza confonderla con Meta Verified.
Scegli numero nuovo, migrazione o coesistenza idonea.
Verifica la proprietà e proteggi il PIN.
Crea un template focalizzato e documenta l'opt-in.
Collega un trigger con tempi, stop, risposte e metrica.
Testa evento, messaggio, risposta, stop e report.
Lancia su un pubblico controllato prima di scalare.
Domande frequenti
Cosa serve per configurare un account WhatsApp Business API?
Prepara portfolio Meta, identità aziendale coerente, WABA, profilo, nome visualizzato, numero idoneo, accesso alla verifica, percorso di setup, template, opt-in e un primo flusso da testare.
La verifica aziendale equivale a Meta Verified?
No. La prima conferma l'organizzazione dietro il portfolio. Meta Verified e i badge sono prodotti di fiducia separati. Nessuno sostituisce registrazione del numero, template, consenso o integrazione funzionante.
Posso usare il numero dell'app WhatsApp Business?
Forse. Alcuni setup richiedono migrazione, altri offrono coesistenza. Dipende da account, regione, provider e idoneità Meta: controlla il flusso attuale prima di modificare o eliminare l'account.
Il numero deve ricevere un SMS?
Deve completare una verifica di proprietà, di solito via SMS o chiamata. Assicurati che il metodo raggiunga qualcuno, soprattutto con fisso, IVR, inoltro o servizi virtuali.
Serve uno sviluppatore?
Sì, se implementi direttamente Cloud API. Una piattaforma o app Shopify può gestire gran parte del livello tecnico, ma l'azienda resta responsabile di identità, accessi, consensi, template, risposte e decisioni sui flussi.
Cosa devo testare prima del lancio?
Testa un evento reale dall'inizio alla fine: pubblico, tempi, template approvato, numero e profilo, link, risposta, stop, consegna e conversione o report operativo.
