Registrare un numero WhatsApp Business su Meta
Questa pagina descrive la procedura, presso Meta, necessaria per predisporre un numero di telefono utilizzabile come canale WhatsApp con Askme Chat. Il percorso si svolge interamente sui portali di Meta (business.facebook.com e developers.facebook.com) e va completato prima di configurare il canale in Askme Chat. Al termine, i dati raccolti vengono comunicati al team Askme, che collega il numero al gateway.
Il team Askme può affiancare il cliente nell'intero processo di censimento su Meta, dalla creazione del portfolio aziendale fino alla registrazione del numero. Per richiedere supporto è sufficiente scrivere a [email protected].
A chi si rivolge e cosa serve prima di iniziare
La procedura si rivolge a chi, presso l'azienda cliente, ha titolo a rappresentare l'organizzazione presso Meta: tipicamente un referente amministrativo o marketing con accesso a un account Facebook e ai documenti societari. Non sono richieste competenze di sviluppo: la configurazione tecnica verso Askme Chat resta a carico del team Askme.
Prima di iniziare è opportuno disporre di:
- un account Facebook personale con cui accedere ai portali Meta (viene usato solo come credenziale amministrativa, non come profilo pubblico);
- i dati legali dell'azienda: denominazione, indirizzo, numero di telefono, sito web ed eventuale codice fiscale/partita IVA, coerenti tra loro e con i documenti ufficiali;
- i documenti societari utili alla verifica dell'azienda (vedi Passo 1): ad esempio visura o certificato di iscrizione, e un documento che attesti indirizzo e recapito (bolletta di utenza, estratto conto intestato all'azienda);
- un numero di telefono dedicato al canale, con i requisiti descritti al Passo 3;
- il nome commerciale (display name) che si desidera mostrare nelle conversazioni, conforme alle regole di Meta.
Nel corso della procedura ricorrono alcuni termini di Meta: Business Portfolio (o «portfolio aziendale», l'insieme delle risorse aziendali su Meta, in passato «Business Manager»), WhatsApp Business Account (WABA) (il contenitore dei numeri WhatsApp) e app (l'applicazione tecnica che espone le API). Questi nomi compaiono nell'interfaccia Meta e sono richiamati nei passi seguenti.
Passo 1 — Business Portfolio e verifica dell'azienda
Il Business Portfolio è il contenitore che raccoglie le risorse aziendali su Meta ed è il prerequisito per usare la WhatsApp Business Platform.
- Accedere a business.facebook.com con l'account Facebook e, se non ne esiste già uno, creare un nuovo portfolio aziendale indicando denominazione, referente ed email di lavoro.
- Compilare l'anagrafica aziendale (Impostazioni dell'azienda › Informazioni sull'azienda) con denominazione legale, indirizzo, numero di telefono e sito web.
- Avviare la verifica dell'azienda (business verification) dalla sezione Centro sicurezza (Security Center) del portfolio, quando disponibile, e caricare i documenti richiesti.
Documenti richiesti per la verifica
Meta richiede in genere documenti che attestino:
- la denominazione legale dell'azienda (ad esempio visura camerale, certificato di iscrizione o documento equivalente);
- l'indirizzo e il recapito telefonico (ad esempio una bolletta di utenza recente, un estratto conto bancario intestato all'azienda o un documento fiscale).
La causa più frequente di ritardi o rifiuti è la mancata corrispondenza tra i dati inseriti su Meta (denominazione, indirizzo, telefono, sito, email) e quelli riportati sui documenti caricati. È necessario che tutte le informazioni coincidano esattamente.
Quando è obbligatoria e tempistiche
La verifica dell'azienda non è sempre richiesta per iniziare le prove, ma diventa necessaria per operare in produzione: in particolare per superare i limiti di messaggistica iniziali, per registrare più numeri di telefono e, in generale, per un uso commerciale continuativo del canale. Si consiglia di avviarla fin da subito.
I tempi di esito sono variabili: l'esito può arrivare in poche ore oppure richiedere diversi giorni lavorativi, in funzione della completezza della documentazione. In caso di rifiuto è possibile correggere i dati o i documenti e ripresentare la richiesta.
La procedura e l'elenco documenti aggiornati sono descritti nel Centro assistenza per le aziende di Meta (business.facebook.com/business/help). L'interfaccia dei portali Meta cambia con frequenza: le denominazioni delle voci di menu possono differire da quanto riportato.
Passo 2 — Creare l'app su developers.facebook.com
L'app è l'oggetto tecnico che abilita le API di WhatsApp e collega il numero al WhatsApp Business Account.
- Accedere a developers.facebook.com con lo stesso account e, se richiesto, completare la registrazione come sviluppatore.
- Selezionare Le mie app › Crea un'app.
- Scegliere il caso d'uso relativo a WhatsApp (ad esempio «Contatta i clienti tramite WhatsApp» / tipo Business), quindi indicare nome dell'app ed email di contatto.
- Associare l'app al Business Portfolio creato al Passo 1.
- Nella dashboard dell'app, aggiungere il prodotto WhatsApp e, nella sezione di configurazione delle API, selezionare o creare il WhatsApp Business Account (WABA) da associare.
Durante la configurazione Meta genera un token di accesso temporaneo utile solo alle prime prove, e per l'uso continuativo si predispone un token permanente tramite un «utente di sistema» (System user) nelle impostazioni dell'azienda. Analogamente, è previsto un webhook per ricevere i messaggi in ingresso. La generazione del token permanente e la configurazione puntuale del webhook verso Askme Chat sono gestite dal team Askme in fase di collegamento (Passo 4): non è necessario completarle autonomamente.
Passo 3 — Numero di telefono e nome visualizzato
Requisiti del numero
Il numero da associare al canale deve soddisfare tutte le condizioni seguenti:
- non essere già registrato sull'app WhatsApp o WhatsApp Business: se il numero è in uso su un'app WhatsApp, va prima eliminato l'account associato da quell'app;
- essere in grado di ricevere un SMS o una chiamata vocale all'indirizzo del codice di verifica;
- disporre di prefisso internazionale e prefisso di rete validi; i numeri brevi (short code) non sono supportati;
- essere nella disponibilità dell'azienda e dedicato al canale (un numero già usato quotidianamente sull'app WhatsApp non è adatto).
Aggiungere e verificare il numero
- Dalla configurazione WhatsApp dell'app (o da WhatsApp Manager), aggiungere il numero di telefono al WhatsApp Business Account.
- Avviare la verifica del possesso del numero e scegliere il metodo di ricezione del codice (SMS o chiamata).
- Inserire il codice ricevuto per confermare il numero.
Nome visualizzato (display name) e approvazione
Al numero va associato un nome visualizzato, ossia il nome commerciale mostrato ai contatti nelle conversazioni. Il nome è soggetto ad approvazione da parte di Meta secondo le relative policy: deve riflettere il nome effettivo dell'azienda o del marchio, evitare abbreviazioni non riconoscibili, riferimenti non pertinenti o formattazioni improprie.
Se il nome visualizzato viene modificato in seguito, il numero potrebbe richiedere una nuova conferma e la messaggistica resta subordinata alla riapprovazione del nome. Conviene quindi definire il display name corretto fin dall'inizio.
Passo 4 — Collegamento con Askme Chat
Completati i passi precedenti, il numero è pronto per essere collegato ad Askme Chat. Il collegamento tecnico al gateway è eseguito dal team Askme: al cliente è richiesto di comunicare i dati necessari.
- Raccogliere gli identificativi generati su Meta: identificativo del WhatsApp Business Account (WABA ID), identificativo del numero di telefono (Phone number ID), identificativo dell'app e il numero stesso.
- Trasmettere tali dati al team Askme, insieme all'esito della verifica dell'azienda, tramite [email protected].
- Il team Askme configura il gateway e le credenziali (incluso il token permanente e il webhook) e conferma quando il canale è attivo.
- Procedere quindi alla configurazione lato modulo descritta in Canale WhatsApp: integrazione del tenant, collegamento del chatbot e messaggi di benvenuto e chiusura.
Token di accesso e credenziali vanno condivisi solo attraverso il canale concordato con il team Askme e non inseriti in documenti pubblici o repository. La gestione tecnica di tali segreti è a carico del team Askme.
Limiti di messaggistica e qualità
Meta applica ai numeri WhatsApp Business alcuni meccanismi che ne governano la capacità di invio. È utile conoscerli per pianificare l'attivazione.
- Limiti di messaggistica (messaging limits). Determinano quanti contatti unici è possibile contattare con messaggi avviati dall'azienda in una finestra mobile di 24 ore. Un numero nuovo, prima della verifica dell'azienda, parte da una soglia iniziale ridotta; con la verifica e con un uso di qualità la soglia cresce progressivamente per livelli successivi, fino ad arrivare a volumi elevati. I limiti riguardano i messaggi avviati dall'azienda: le risposte entro la finestra di assistenza di 24 ore aperta dal contatto non vi rientrano.
- Numero massimo di numeri registrati. Un portfolio non ancora verificato può registrare un numero limitato di numeri di telefono; con la verifica dell'azienda la capacità aumenta.
- Qualità del numero (quality rating). Meta assegna a ciascun numero una valutazione di qualità (alta/media/bassa, spesso indicata come verde/giallo/rosso) calcolata sui segnali dei destinatari: risposte e interazioni la migliorano, blocchi e segnalazioni come spam la peggiorano. Una qualità bassa può bloccare la crescita dei limiti o ridurli.
- Template dei messaggi. I messaggi avviati dall'azienda fuori dalla finestra di 24 ore richiedono l'uso di template approvati da Meta. La gestione dei template in Askme Chat è descritta in Template dei messaggi.
Per aumentare i limiti conviene completare la verifica dell'azienda, mantenere il numero in stato «connesso» con qualità medio-alta e inviare messaggi solo a contatti che hanno prestato il consenso, evitando invii a freddo che generano blocchi e segnalazioni.
L'uso di WhatsApp Business Platform prevede una fatturazione a carico di Meta, basata sulle conversazioni. Gli importi e le modalità sono definiti da Meta e consultabili nella documentazione ufficiale; non sono gestiti da Askme.
Problemi comuni
| Problema | Causa probabile | Come procedere |
|---|---|---|
| Verifica dell'azienda respinta | Dati su Meta non coincidenti con i documenti, oppure documenti poco leggibili o non pertinenti | Allineare denominazione, indirizzo, telefono e sito ai documenti, caricare documenti chiari e recenti e ripresentare la richiesta |
| Nome visualizzato rifiutato | Nome non conforme alle policy (abbreviazioni, riferimenti non pertinenti, formattazione impropria) | Indicare il nome effettivo dell'azienda o del marchio e ripresentare la richiesta di approvazione |
| Numero già in uso | Il numero risulta registrato sull'app WhatsApp o WhatsApp Business | Eliminare l'account WhatsApp associato a quel numero, quindi ripetere l'aggiunta e la verifica |
| Codice di verifica non ricevuto | Numero non in grado di ricevere SMS/chiamata, oppure troppi tentativi ravvicinati | Verificare la raggiungibilità del numero, provare il metodo alternativo (chiamata) e attendere prima di ripetere |
| Limiti di invio bassi o bloccati | Azienda non verificata o qualità del numero peggiorata | Completare la verifica dell'azienda e migliorare la qualità riducendo invii non richiesti |
Assistenza
Per qualsiasi difficoltà nella procedura su Meta, o per delegare in tutto o in parte il censimento, è possibile rivolgersi al team Askme scrivendo a [email protected]. Il team può affiancare il cliente nella creazione del portfolio, nella verifica dell'azienda, nella registrazione del numero e nel successivo collegamento del canale.
La documentazione ufficiale di Meta resta il riferimento aggiornato per i dettagli operativi:
- WhatsApp Business Platform — documentazione per sviluppatori
- Centro assistenza per le aziende di Meta