Problemi Comuni Durante la Registrazione a WhatsApp: Guida alla Risoluzione
Riepilogo
Configurare la WhatsApp Business API tramite WhatsTeam dovrebbe essere un processo semplice, ma alcune situazioni possono causare complicazioni durante la registrazione. Che il tuo numero sia già connesso a un altro Business Solution Provider (BSP), registrato su un account WhatsApp personale o collegato a un diverso portfolio Meta, ogni scenario richiede un percorso di risoluzione specifico.
Questa guida completa ti accompagna attraverso i problemi più comuni riscontrati durante la registrazione a WhatsApp e fornisce istruzioni chiare, passo dopo passo, per risolverli in modo da poter avviare la tua attività su WhatsTeam il più rapidamente possibile.
Checklist Pre-Integrazione
Prima di iniziare il processo di registrazione a WhatsApp su WhatsTeam, assicurati di avere i seguenti elementi pronti. Completare questa checklist in anticipo ti farà risparmiare tempo e prevenirai i blocchi più comuni.

- Un numero di telefono valido: Questo numero deve essere in grado di ricevere SMS o chiamate vocali per la verifica. Non deve essere attualmente attivo sull'app mobile WhatsApp o WhatsApp Business standard, a meno che tu non stia pianificando di migrarlo.
- Un Meta Business Account: Hai bisogno di un Meta Business Account attivo (precedentemente Facebook Business Manager). Se non ne hai uno, verrà creato durante il flusso di Embedded Signup.
- Documenti di verifica aziendale: Prepara la tua documentazione legale aziendale come certificati di registrazione, numeri di identificazione fiscale o atti costitutivi.
- Accesso admin a Meta Business Suite: Se hai già un Meta Business Account, assicurati di avere permessi a livello di amministratore.
- Autenticazione a due fattori (2FA) disabilitata: Se il numero di telefono è attualmente utilizzato su un'app mobile WhatsApp, disabilita la 2FA nelle impostazioni dell'app prima di procedere.
- Requisiti del browser: Usa un browser moderno (Chrome, Firefox, Edge) con i popup abilitati per il flusso di accesso Meta.

Suggerimento: Avere tutti questi elementi preparati prima di iniziare ridurrà drasticamente la probabilità di incontrare errori durante il processo di registrazione.
Numero Connesso a un'Altra Piattaforma Business
Uno dei problemi più frequenti si verifica quando il tuo numero di telefono è già registrato con un altro WhatsApp Business Solution Provider (BSP). WhatsApp applica una rigorosa politica di un provider per numero, il che significa che un singolo numero di telefono può essere attivo su un solo BSP in qualsiasi momento.

Come Identificare Questo Problema
Tipicamente vedrai uno dei seguenti messaggi di errore durante la registrazione:
- "Questo numero è registrato su un account WhatsApp esistente"
- "Impossibile migrare il numero di telefono. L'account WhatsApp a cui è registrato questo numero non è configurato correttamente."
- "Il numero di telefono è già in uso da un altro client WhatsApp Business API"
Perché Succede
Questa situazione si presenta quando:
- Il tuo numero era precedentemente connesso a un diverso BSP (come Twilio, MessageBird o 360dialog) e non è mai stato formalmente disconnesso.
- Il tuo numero è ancora attivo sulla WhatsApp Business mobile app.
- Un precedente dipendente o agenzia ha configurato il numero su una piattaforma diversa senza la tua conoscenza.

Panoramica della Risoluzione
La risoluzione dipende dalla tua configurazione attuale. Hai due percorsi principali:
- Percorso Cloud API: Disconnetti completamente il numero dal provider attuale e ri-registralo su WhatsTeam.
- Percorso Coesistenza: Se vuoi mantenere il numero attivo sulla WhatsApp Business mobile app utilizzandolo contemporaneamente tramite l'API di WhatsTeam.
Entrambi i percorsi sono descritti in dettaglio nelle sezioni seguenti.
Passaggio tra BSP
Se il tuo numero è attualmente gestito da un altro BSP e vuoi spostarlo su WhatsTeam, devi eseguire una migrazione formale. Questo processo richiede il coordinamento tra il tuo provider attuale, Meta e WhatsTeam.

Prima del Passaggio
- Informa il tuo BSP attuale: Alcuni provider richiedono un preavviso prima di rilasciare un numero. Consulta la loro documentazione o contatta il loro team di supporto.
- Esporta i tuoi template: I modelli di messaggio WhatsApp sono legati al WhatsApp Business Account (WABA), non al BSP. Se ti stai spostando su un nuovo WABA, dovrai ricreare i tuoi template.
- Annota i tuoi limiti di messaggistica: Il tuo livello di messaggistica attuale (1K, 10K, 100K o illimitato) potrebbe o meno trasferirsi a seconda che tu mantenga lo stesso WABA.
- Esegui il backup dei dati delle conversazioni: Le conversazioni attive e la cronologia delle chat sono gestite dal BSP. Esporta tutti i dati necessari prima di avviare il passaggio.
Migrazione vs Nuovo Inizio
| Fattore | Migrazione (Stesso WABA) | Nuovo Inizio (Nuovo WABA) |
|---|
| Template | Preservati | Da ricreare |
| Limite messaggistica | Preservato | Riparte da 1K/giorno |
| Valutazione qualità | Preservata | Riparte da zero |
| Nome visualizzato | Preservato | Da ri-approvare |
| Tempo di inattività | Minuti | Da minuti a ore |

Raccomandazione: Quando possibile, migra usando lo stesso WABA per preservare i tuoi limiti di messaggistica e le approvazioni dei template. Questo è particolarmente importante per le aziende con alti volumi di messaggi giornalieri.
Eliminare il Numero dall'Account WhatsApp Attuale
Prima di poter registrare il tuo numero su WhatsTeam, devi rimuoverlo dal suo account WhatsApp attuale. Il processo differisce a seconda che il tuo numero sia sulla Cloud API o tu stia pianificando di usare la modalità Coesistenza.
Percorso Cloud API
Il percorso Cloud API prevede la rimozione completa del numero dalla sua registrazione WhatsApp attuale in modo che possa essere registrato nuovamente su WhatsTeam.

Passaggio 1: Accedi a Meta Business Suite
- Vai su business.facebook.com e accedi con il tuo account admin.
- Vai su Impostazioni nella barra laterale sinistra.
- Clicca su Account WhatsApp nel menu delle Impostazioni Business.

Passaggio 2: Individua il Tuo Numero di Telefono
- Seleziona il WhatsApp Business Account che contiene il tuo numero di telefono.
- Clicca sulla scheda Numeri di Telefono.
- Trova il numero che vuoi rimuovere da questo account.

Passaggio 3: Elimina il Numero di Telefono
- Clicca sul numero di telefono per selezionarlo.
- Clicca il pulsante Elimina (icona cestino) accanto al numero.
- Conferma l'eliminazione quando richiesto.
- Attendi almeno 5 minuti affinché i sistemi di Meta elaborino completamente la rimozione.

Attenzione: L'eliminazione di un numero di telefono da un WABA è permanente. Tutta la cronologia dei messaggi, le conversazioni attive e i messaggi in sospeso associati a quel numero andranno persi. Assicurati di aver esportato tutti i dati necessari prima di procedere.
Passaggio 4: Verifica che il Numero sia Rilasciato
- Torna alla scheda Numeri di Telefono.
- Conferma che il numero non appaia più nell'elenco.
- Se il numero appare ancora, attendi qualche minuto in più e aggiorna la pagina.

Passaggio 5: Cancella l'App Mobile WhatsApp (Se Applicabile)
Se il numero era anche utilizzato sull'app mobile WhatsApp o WhatsApp Business:
- Apri l'app WhatsApp sul tuo telefono.
- Vai su Impostazioni > Account > Elimina il mio account.
- Inserisci il tuo numero di telefono e conferma l'eliminazione.
- Disinstalla l'app per prevenire la ri-registrazione automatica.

Percorso Coesistenza
Il percorso Coesistenza ti permette di continuare a usare la WhatsApp Business mobile app sul tuo telefono connettendo contemporaneamente lo stesso numero a WhatsTeam tramite la Cloud API. Questo è ideale per le aziende che vogliono mantenere la loro presenza WhatsApp esistente ottenendo al contempo le capacità dell'API.

Passaggio 1: Assicurati di Usare la WhatsApp Business App
La Coesistenza funziona solo con l'app WhatsApp Business (icona verde con una "B"), non con l'app WhatsApp consumer standard. Se stai usando l'app WhatsApp normale, devi prima migrare alla WhatsApp Business app.

Passaggio 2: Disabilita le Funzionalità di Risposta Automatica
Prima di connetterti tramite la Coesistenza, disabilita tutte le funzionalità di risposta automatica nella tua WhatsApp Business app:
- Apri l'app WhatsApp Business.
- Vai su Impostazioni > Strumenti Business > Messaggio d'assenza e disattivalo.
- Vai su Impostazioni > Strumenti Business > Messaggio di benvenuto e disattivalo.
- Vai su Impostazioni > Strumenti Business > Risposte rapide e rivedile (possono rimanere attive ma tieni presente che potrebbero entrare in conflitto con le automazioni dell'API).
Passaggio 3: Non Eliminare il Numero
A differenza del percorso Cloud API, non dovresti eliminare il numero dall'app mobile. Il numero resta attivo sull'app mentre lo connetti a WhatsTeam tramite il processo di Embedded Signup.
Passaggio 4: Procedi con la Registrazione su WhatsTeam
Con l'app mobile ancora attiva, procedi con il processo di registrazione su WhatsTeam. Durante l'Embedded Signup, seleziona l'opzione Coesistenza quando richiesto. I passaggi dettagliati per questo processo sono trattati nella nostra guida dedicata alla Coesistenza.

Creare un Nuovo Account WhatsApp
Se stai partendo da zero o il tuo account precedente non può essere recuperato, dovrai creare un nuovo WhatsApp Business Account. Ci sono due metodi principali per farlo tramite WhatsTeam.
Embedded Sign-Up Tramite WhatsTeam
Il flusso Embedded Signup (ES) è il metodo più veloce e consigliato. Crea il tuo Meta Business Account e il WhatsApp Business Account in un singolo processo semplificato direttamente all'interno della piattaforma WhatsTeam.

Passaggio 1: Vai alle Impostazioni di WhatsTeam
- Accedi al tuo account WhatsTeam su whats.team.
- Vai su Impostazioni > Connessioni WhatsApp.
- Clicca il pulsante Connetti un Nuovo Numero.
Passaggio 2: Avvia l'Embedded Signup
- Apparirà una finestra di accesso Meta.
- Accedi con le credenziali del tuo account Facebook.
- Se non hai un Meta Business Account, ne verrà creato uno automaticamente durante questo processo.

Passaggio 3: Crea o Seleziona un Portfolio Business
- Scegli Crea un nuovo Portfolio Business se è la tua prima volta, oppure selezionane uno esistente dal menu a tendina.
- Inserisci il nome della tua attività esattamente come appare sui tuoi documenti legali.
- Clicca Continua.

Passaggio 4: Crea un WhatsApp Business Account
- Scegli Crea un nuovo WhatsApp Business Account.
- Inserisci un nome visualizzato per la tua attività (questo è ciò che i clienti vedranno).
- Seleziona la categoria della tua attività dal menu a tendina.
- Clicca Continua.
Passaggio 5: Aggiungi il Tuo Numero di Telefono
- Inserisci il numero di telefono che vuoi registrare.
- Seleziona il metodo di verifica preferito: SMS o Chiamata Vocale.
- Inserisci il codice di verifica quando lo ricevi.
- Clicca Verifica.

Passaggio 6: Completa la Configurazione
- Rivedi tutte le informazioni fornite.
- Accetta i termini e le condizioni.
- Clicca Completa Configurazione.
- Verrai reindirizzato alla dashboard WhatsTeam dove apparirà la tua nuova connessione.

Tramite Portfolio Meta Business
Se preferisci creare il tuo WhatsApp Business Account direttamente tramite Meta prima di connetterti a WhatsTeam, puoi farlo tramite Meta Business Suite.

Passaggio 1: Accedi a Meta Business Suite
- Vai su business.facebook.com.
- Accedi con il tuo account admin Facebook.
- Vai su Impostazioni > Impostazioni Business.
Passaggio 2: Crea un WhatsApp Business Account
- Nella barra laterale sinistra, clicca Account > Account WhatsApp.
- Clicca il pulsante Aggiungi.
- Compila i dettagli richiesti: nome account, valuta e fuso orario.
- Clicca Crea.

Passaggio 3: Aggiungi un Numero di Telefono
- All'interno del tuo nuovo WABA, vai alla scheda Numeri di Telefono.
- Clicca Aggiungi Numero di Telefono.
- Inserisci il numero e verificalo tramite SMS o chiamata vocale.
Passaggio 4: Condividi l'Accesso con WhatsTeam
- Nelle impostazioni del tuo WABA, vai alla sezione Partner o Solution Provider.
- Aggiungi WhatsTeam come solution provider usando il Business Manager ID di WhatsTeam.
- Concedi i permessi richiesti (gestire numeri di telefono, gestire template, inviare messaggi).
Passaggio 5: Connetti in WhatsTeam
- Torna alla dashboard WhatsTeam.
- Vai su Impostazioni > Connessioni WhatsApp.
- Clicca Connetti Account Esistente.
- Seleziona il WABA che hai appena creato dall'elenco.

Collegare il WhatsApp Business Account al Portfolio (Coesistenza)
Quando usi la modalità Coesistenza, potresti dover collegare il tuo WhatsApp Business Account a un Portfolio Meta Business specifico. Questo passaggio assicura che il WABA sia correttamente associato alla tua identità aziendale e che fatturazione, permessi e conformità siano configurati correttamente.

Quando È Necessario?
- Hai creato un WABA tramite Embedded Signup e devi assegnarlo a un portfolio diverso.
- Stai configurando la Coesistenza e Meta richiede che il WABA sia sotto un portfolio verificato.
- La tua attività ha più portfolio e devi consolidare i tuoi account WhatsApp.
Come Collegare
- Apri Meta Business Suite e vai su Impostazioni Business.
- Vai su Account > Account WhatsApp.
- Seleziona il WABA che vuoi collegare.
- Clicca Assegna Partner o Aggiungi Persone/Partner.
- Inserisci l'ID del Portfolio Business dove vuoi che il WABA risieda.
- Conferma l'assegnazione e attendi che Meta elabori la modifica (questo può richiedere fino a 24 ore).

Verifica il Collegamento
Dopo il collegamento, verifica che:
- Il WABA appaia sotto il portfolio corretto nelle Impostazioni Business di Meta.
- Tutti i numeri di telefono all'interno del WABA siano visibili e attivi.
- Le approvazioni dei template e i limiti di messaggistica siano intatti.
- WhatsTeam possa ancora accedere al WABA tramite la connessione.

Registrare Nuovamente il Numero Sotto un Nuovo Account
In alcuni casi, potresti dover registrare un numero di telefono precedentemente utilizzato su un diverso account WhatsApp. Questo processo richiede un'esecuzione attenta per evitare errori.

Prerequisiti
Prima di tentare la ri-registrazione di un numero:
- Assicurati che il numero sia completamente eliminato da qualsiasi precedente account WhatsApp (Cloud API, On-Premises API o app mobile).
- Attendi il periodo di raffreddamento richiesto. Dopo l'eliminazione, Meta applica un periodo di attesa che può variare da pochi minuti a 24 ore a seconda della cronologia dell'account.
- Verifica la proprietà del numero. Devi essere in grado di ricevere SMS o chiamate vocali sul numero durante il passaggio di verifica.
Ri-Registrazione Passo dopo Passo
Passaggio 1: Conferma l'Eliminazione
Vai su Meta Business Suite e verifica che il numero non appaia sotto nessun WhatsApp Business Account. Se appare ancora, completa il processo di eliminazione descritto in precedenza in questa guida.

Passaggio 2: Avvia una Nuova Registrazione su WhatsTeam
- Accedi al tuo account WhatsTeam.
- Vai su Impostazioni > Connessioni WhatsApp.
- Clicca Connetti un Nuovo Numero.
- Segui il flusso di Embedded Signup come descritto nella sezione "Creare un Nuovo Account WhatsApp" sopra.
Passaggio 3: Verifica il Numero
- Quando richiesto, inserisci il numero di telefono.
- Seleziona SMS o Chiamata Vocale per la verifica.
- Inserisci il codice OTP ricevuto.
- Se il codice non arriva, attendi 60 secondi e prova il metodo di verifica alternativo.

Passaggio 4: Conferma la Registrazione Riuscita
- Dopo la verifica, il numero dovrebbe apparire nella tua dashboard WhatsTeam con stato Attivo.
- Invia un messaggio di test per confermare che la connessione funziona correttamente.
- Se la registrazione fallisce con un errore riguardante il numero ancora in uso, attendi altri 30 minuti e riprova.

Domande Frequenti
Quanto tempo ci vuole per rilasciare un numero da un altro BSP?
Il processo di rilascio è generalmente istantaneo una volta eliminato il numero dal WABA precedente. Tuttavia, in alcuni casi, i sistemi di Meta potrebbero richiedere fino a 24 ore per propagare completamente la modifica. Se continui a riscontrare problemi dopo 24 ore, contatta il supporto WhatsTeam a support@whats.team.
Posso usare lo stesso numero sia sulla WhatsApp Business App che sulla Cloud API?
Sì, questo è esattamente ciò che la modalità Coesistenza abilita. Puoi continuare a usare la WhatsApp Business mobile app inviando e ricevendo contemporaneamente messaggi tramite l'API di WhatsTeam. Tuttavia, ci sono alcune limitazioni delle funzionalità in modalità Coesistenza. Consulta la nostra guida dedicata alla Coesistenza per i dettagli completi.
Cosa succede ai miei modelli di messaggio quando cambio BSP?
Se mantieni lo stesso WABA, i tuoi template approvati saranno preservati. Se crei un nuovo WABA, dovrai inviare nuovamente tutti i template per l'approvazione, il che può richiedere fino a 24 ore per template.
Perderò il mio livello di limite di messaggistica quando mi ri-registro?
Se elimini un numero da un WABA e lo registri sotto un nuovo WABA, il tuo limite di messaggistica si azzera al livello predefinito (tipicamente 1.000 conversazioni avviate dall'azienda per 24 ore). Per preservare il tuo livello di messaggistica, migra il numero all'interno dello stesso WABA quando possibile.
Continuo a ricevere "Impossibile inviare il codice" durante la verifica. Cosa devo fare?
Questo errore indica generalmente un problema temporaneo con il servizio di verifica di Meta. Prova quanto segue:
- Attendi 5-10 minuti e riprova.
- Alterna tra i metodi di verifica SMS e chiamata vocale.
- Assicurati che il numero non sia su un servizio VoIP che blocca i codici brevi.
- Controlla la console sviluppatori del tuo browser per ulteriori dettagli sull'errore.
- Se il problema persiste, contatta il supporto WhatsTeam con i log della console del browser.
Il mio numero risulta "In attesa" dopo la registrazione. È normale?
Sì, un breve stato "In attesa" è normale mentre Meta elabora la registrazione. Questo si risolve tipicamente entro 5-15 minuti. Se lo stato rimane "In attesa" per più di un'ora, prova ad aggiornare la connessione nella dashboard WhatsTeam o contatta il supporto.