Vai al contenuto
OmniChannels.ai

Quale numero per l'API di WhatsApp Business? Regole

Quale numero usare per l'API di WhatsApp Business? Regole di Meta per numeri mobili, fissi, verdi e virtuali, codici via SMS o voce e numeri già su WhatsApp.

Aggiornato 9 min di lettura

Di OmniChannels.ai Editorial Team · Revisione di BroadNet Messaging Solutions Team

WhatsApp

Risposta breve

Per l'API di WhatsApp Business usate un numero di vostra proprietà, con prefisso internazionale e prefisso locale, in grado di ricevere un SMS o una chiamata vocale. I short code non sono supportati. Meta consiglia i numeri mobili; fissi, verdi e virtuali possono funzionare se ricevono il codice di verifica, di solito tramite chiamata vocale. Un numero già in uso su WhatsApp va prima eliminato, a meno che sia un numero della WhatsApp Business app collegato tramite coexistence.

In questa pagina
  1. Quale numero di telefono si può usare per l'API di WhatsApp Business?
  2. Si può usare un numero fisso, verde o virtuale?
  3. Come si riceve il codice di verifica?
  4. E se il numero è già su WhatsApp?
  5. Quanti numeri di telefono può registrare un'azienda?
  6. Ci sono aspetti legati al Paese?
  7. Come si mantiene la proprietà del numero?
  8. Quali sono gli errori comuni?
  9. Esempio pratico: un rivenditore di Gedda
  10. Come vi aiuta OmniChannels.ai

Punti chiave

  • Meta richiede che il numero sia vostro, abbia prefisso internazionale e locale, possa ricevere chiamate vocali o SMS e non sia uno short code.
  • I numeri mobili sono il tipo consigliato; per fissi, verdi e virtuali Meta valuta i codici via SMS come sconsigliati e quelli vocali come standard.
  • Un numero in uso su WhatsApp non può essere registrato finché non viene eliminato, tranne i numeri della WhatsApp Business app che collegate tramite coexistence.
  • Un nuovo portfolio aziendale può registrare due numeri di telefono aziendali; la verifica, o il raggiungimento di un limite di messaggi di 2.000, alza il tetto a 20.
  • Tenete il numero a vostro nome e nel vostro portfolio, perché un numero che non controllate non potete recuperarlo, migrarlo né verificarlo.

Questa guida è pensata per chi sceglie il numero di telefono per l'API di WhatsApp Business. Elenca quali tipi di numero accetta Meta, come arriva il codice di verifica, cosa fare se il numero è già su WhatsApp, quanti numeri può registrare un'azienda e come mantenerne il controllo. Le regole di Meta cambiano, quindi confermatele nelle pagine per sviluppatori collegate.

Quale numero di telefono si può usare per l'API di WhatsApp Business?

Usate un numero di vostra proprietà, con prefisso internazionale e locale, in grado di ricevere un SMS o una chiamata vocale. Meta precisa anche che il numero deve avere capacità scalate e che gli short code non sono supportati.

Le quattro condizioni della documentazione di Meta sui numeri di telefono sono:

  1. Di vostra proprietà. Il numero dovrebbe appartenere alla vostra azienda, non a un'agenzia o a un dipendente.
  2. Prefisso internazionale e locale. Deve essere un numero internazionale completo, quindi gli short code sono esclusi.
  3. In grado di ricevere chiamate vocali o SMS. È così che arriva il codice di verifica.
  4. Capacità scalate. Meta lo indica come requisito senza altri dettagli nella pagina che abbiamo esaminato, quindi chiedete al vostro operatore telefonico o al nostro team se avete dubbi.

La WhatsApp Business Platform tratta ogni numero come un numero di telefono aziendale collegato a un solo account WhatsApp Business. Un numero non è un accesso né una postazione di lavoro: tutti i vostri operatori lo condividono tramite la casella condivisa. La nostra guida alla configurazione mostra dove si colloca il numero nell'attivazione.

Si può usare un numero fisso, verde o virtuale?

Spesso sì, purché possa ricevere la chiamata di registrazione. Meta consiglia i numeri mobili e valuta gli altri tipi come segue.

Tipo di numero Codice SMS (valutazione di Meta) Codice vocale (valutazione di Meta) Note
Mobile Standard (tipo consigliato) Standard La via più semplice
Fisso (linea fissa) Sconsigliato Standard Richiedete il codice con una chiamata vocale
Numero verde (freephone) Sconsigliato Standard Richiedete il codice con una chiamata vocale
Virtuale (VoIP) Sconsigliato Standard Il fornitore deve supportare SMS o chiamate internazionali per gli OTP
Numero dietro un IVR (tipo 1-800) Non trattato Deve accettare chiamate internazionali Si può registrare se la chiamata di registrazione vi raggiunge
Pager Non supportato Non supportato
SIM M2M / IoT Sconsigliato Sconsigliato

Per i numeri virtuali il rischio pratico è che un fornitore blocchi i codici internazionali in ingresso. Provate una chiamata internazionale in ingresso prima di iniziare e mantenete il numero attivo dopo la registrazione.

Come si riceve il codice di verifica?

Richiedete un codice via SMS o con una chiamata vocale, poi inserite il codice ricevuto. La documentazione di Meta afferma che i numeri di telefono devono essere verificati con un codice inviato via SMS o chiamata vocale.

Nell'API sono due chiamate: una richiesta di codice con code_method impostato su SMS o VOICE e una lingua, poi una chiamata di verifica con il codice. Se il numero è già verificato, la richiesta di codice restituisce HTTP 400 con codice di errore 136024, quindi controllate prima lo stato di verifica. Se vi attivate con Embedded Signup, lo fanno le schermate per voi.

Consigli per una verifica senza intoppi:

  • Usate una SIM o una linea che avete in mano quando iniziate.
  • Per un numero fisso, fate stare qualcuno vicino al telefono e richiedete l'opzione vocale.
  • Se usate un IVR, assicuratevi che la chiamata possa raggiungere una persona o un interno che legga il codice.
  • Tenete presente la verifica in due passaggi: Meta richiede un PIN quando registrate un numero aziendale, e vi servirà più avanti per cambiare il PIN o eliminare il numero. Conservatelo nel vostro gestore di password.

E se il numero è già su WhatsApp?

Un numero già in uso con WhatsApp non può essere registrato se non viene prima eliminato. Lo afferma la documentazione di Meta, che aggiunge che un numero bloccato deve essere sbloccato tramite la procedura di ricorso prima della registrazione.

Avete tre opzioni:

Opzione Quando è adatta A cosa rinunciate
Usare un numero nuovo Volete una separazione netta I clienti devono imparare il nuovo numero
Eliminare il numero dall'account WhatsApp, poi registrarlo Non vi serve più la cronologia delle chat su quell'app Le vecchie chat; fate prima il backup
Collegare un numero della WhatsApp Business app tramite coexistence Volete continuare a usare la Business app insieme all'API Alcune funzioni dell'app cambiano (vedi sotto)

Per la coexistence, l'azienda usa Embedded Signup con un provider, e la documentazione di Meta descrive questi effetti: l'azienda continua a usare la Business app, le app companion vengono scollegate all'attivazione, le chat di gruppo non vengono sincronizzate, le liste broadcast esistenti diventano di sola lettura e si può sincronizzare fino a sei mesi di cronologia chat. I messaggi inviati dall'app restano gratuiti. Meta richiede una versione minima della Business app, quindi controllate il requisito attuale prima di iniziare.

Se spostate da un provider all'altro un numero già presente sull'API, si tratta di una migrazione e non di una nuova registrazione. Vedi migrare un numero WhatsApp tra provider.

Quanti numeri di telefono può registrare un'azienda?

Un nuovo portfolio aziendale può registrare due numeri di telefono aziendali. La documentazione di Meta afferma che il tetto sale a 20 quando l'azienda è verificata o raggiunge un limite di messaggi di 2.000.

I limiti di messaggi sono impostati a livello di portfolio e condivisi da tutti i numeri del portfolio, quindi un numero può usare l'intera capacità in un periodo. Se pianificate più numeri, ad esempio vendite, assistenza e fatturazione, pensate a cosa fa ciascuno:

  • un numero per mercato, così il prefisso sembra locale;
  • un numero per brand, con il proprio nome visualizzato;
  • un numero per il marketing e uno per l'assistenza, che rende più leggibile la qualità.

Ogni numero richiede il proprio nome visualizzato; vedi la guida al nome visualizzato. Alzare il tetto è uno dei motivi per completare la verifica aziendale. Controllate in Business Suite il tetto attuale del vostro portfolio.

Ci sono aspetti legati al Paese?

Sì, soprattutto nell'aspetto dei numeri e in chi può ricevere la chiamata di verifica. Scegliete un numero coerente con il mercato che servite e verificate che il vostro fornitore possa consegnarvi i codici.

  • Numeri locali ed esteri. Un'azienda con sede negli Emirati Arabi Uniti può registrare un numero +971; un'azienda che serve clienti sauditi può registrare un numero +966 se ne possiede uno. Alcuni clienti si fidano di più di un numero locale.
  • Formattazione. Meta osserva che per Brasile e Messico la Cloud API può aggiungere un prefisso extra ai numeri, e questo è considerato un comportamento normale. Conservate sempre i numeri in formato E.164; il nostro formattatore di numeri di telefono li convalida.
  • Norme sulle telecomunicazioni. Le norme locali su chi può detenere o noleggiare un numero possono variare da Paese a Paese. Chiedete al vostro operatore telefonico e all'autorità di regolamentazione, senza dare per scontato che un numero estero o virtuale sia consentito.

Le nostre pagine dei mercati spiegano il contesto locale, ad esempio WhatsApp negli Emirati Arabi Uniti e WhatsApp in Arabia Saudita.

Come si mantiene la proprietà del numero?

Tenete il numero registrato a nome della vostra azienda, con il vostro portfolio aziendale come proprietario dell'account WhatsApp Business. Se un provider detiene il numero a proprio nome, non potete spostarlo, recuperarlo né dimostrarne la proprietà.

  • Acquistate o mantenete il numero presso un operatore di telecomunicazioni a nome della vostra azienda.
  • Tenete il portfolio sotto i vostri account amministratore, con almeno due amministratori.
  • Conservate il PIN della verifica in due passaggi in un gestore di password condiviso.
  • Solo un amministratore del portfolio aziendale può eliminare un numero di telefono aziendale, e Meta non consente l'eliminazione se il numero ha inviato messaggi a pagamento negli ultimi 30 giorni.
  • Non lasciate che un provider riassegni un numero da cui dipendete senza un piano scritto.

Embedded Signup, che BroadNet utilizza, crea l'account tra i vostri asset Meta fin dal primo giorno.

Quali sono gli errori comuni?

  • Usare una SIM personale. Un numero che se ne va con un dipendente è difficile da recuperare.
  • Scegliere uno short code o una linea a tariffazione speciale. Gli short code non sono supportati.
  • Avviare la verifica senza avere il telefono a portata di mano. Assicuratevi che qualcuno possa leggere un SMS o rispondere alla chiamata vocale quando richiedete il codice.
  • Ignorare l'account WhatsApp esistente. Il numero va prima eliminato o collegato tramite coexistence.
  • Registrarsi tramite un fornitore virtuale che blocca gli SMS internazionali. Usate la voce o scegliete un altro numero.
  • Dimenticare il tetto. Pianificate una verifica prima di avere bisogno del terzo numero.

Esempio pratico: un rivenditore di Gedda

"Waha Market", una catena di alimentari fittizia, vuole un numero per l'assistenza e uno per il marketing. Il team di assistenza usa già la Business app sul cellulare del negozio, mentre il marketing ha un numero fisso della sede centrale.

Il team collega il numero della Business app del negozio tramite coexistence con un provider, accettando che le liste broadcast diventino di sola lettura, e registra il numero fisso con una chiamata vocale. Entrambi i numeri sono a nome dell'azienda e stanno in un unico portfolio con due amministratori. Richiedono la verifica prima di avere bisogno del terzo numero, perché un nuovo portfolio è limitato a due. Ognuno riceve un nome visualizzato con il brand e il reparto.

Come vi aiuta OmniChannels.ai

OmniChannels.ai attiva i numeri dell'API di WhatsApp Business tramite Meta Embedded Signup, così numero, portfolio e nome visualizzato rientrano nei vostri asset Meta. BroadNet è un Meta Business Solution Provider ufficiale e il nostro team prepara con voi registrazione del numero, verifica aziendale e nome visualizzato; le decisioni di approvazione restano a Meta. Usate la lista di controllo per l'attivazione dell'API di WhatsApp per valutare il vostro numero, poi richiedete una demo.

Domande frequenti

Posso usare un numero fisso per l'API di WhatsApp Business?

Sì, se rispetta i requisiti di Meta: è vostro, ha prefisso internazionale e locale e può ricevere una chiamata vocale. Meta valuta i codici via SMS verso i numeri fissi come sconsigliati e quelli vocali come standard, quindi richiedete il codice con una chiamata vocale. Provate la chiamata in anticipo, perché un numero fisso che non riesce a ricevere la chiamata di registrazione fallisce.

Posso usare un numero verde o virtuale?

Spesso sì, a certe condizioni. Per i numeri verdi e virtuali (VoIP) Meta valuta la verifica vocale come standard e quella via SMS come sconsigliata. I numeri dietro un risponditore IVR si possono registrare ma devono accettare chiamate da numeri internazionali. Un fornitore di numeri virtuali deve supportare SMS o chiamate internazionali per il codice.

Come ricevo il codice di verifica per l'API di WhatsApp Business?

Richiedete il codice via SMS o con una chiamata vocale, scegliendo il metodo e una lingua, e poi inserite il codice ricevuto. Un numero mobile gestisce entrambi i metodi in modo standard. Per fissi, verdi e virtuali la scelta affidabile è la voce. Il nostro team può farlo con voi durante l'attivazione.

Posso usare un numero già presente sull'app WhatsApp?

Un numero già in uso con WhatsApp non può essere registrato sull'API se non viene prima eliminato, quindi fate il backup delle chat che volete conservare. L'eccezione è un numero della WhatsApp Business app che collegate con la coexistence tramite Embedded Signup, che permette all'azienda di continuare a usare l'app insieme all'API.

Quanti numeri di telefono può avere un account WhatsApp Business?

Meta limita un nuovo portfolio aziendale a due numeri di telefono aziendali registrati. Il tetto sale a 20 quando l'azienda è verificata o raggiunge un limite di messaggi di 2.000. I limiti di messaggi sono condivisi da tutti i numeri del portfolio, quindi un solo numero molto attivo può consumare l'intera quota.

Dopo la registrazione posso ancora chiamare e inviare SMS dal numero?

Sì. Meta afferma che un numero registrato può essere ancora usato per scopi quotidiani come chiamate e SMS, ma non può più essere usato con la normale app WhatsApp. I codici di verifica via voce e SMS continuano ad arrivare sul numero, quindi tenetelo attivo.

Fonti

  1. Phone numbers: WhatsApp Business Platform, Meta for Developers
  2. Phone numbers: WhatsApp Cloud API, Meta for Developers
  3. Onboarding WhatsApp Business app users (coexistence): Meta for Developers
  4. Messaging limits: WhatsApp Business Platform, Meta for Developers
  5. Display names: WhatsApp Business Platform, Meta for Developers