Risoluzione problemi passo passo per la registrazione API WhatsApp Business — cambio BSP, eliminazione numeri, creazione nuove WABA e registrazione.
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.
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.
Suggerimento: Avere tutti questi elementi preparati prima di iniziare ridurrà drasticamente la probabilità di incontrare errori durante il processo di registrazione.
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.
Tipicamente vedrai uno dei seguenti messaggi di errore durante la registrazione:
Questa situazione si presenta quando:
La risoluzione dipende dalla tua configurazione attuale. Hai due percorsi principali:
Entrambi i percorsi sono descritti in dettaglio nelle sezioni seguenti.
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.
| 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.
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.
Il percorso Cloud API prevede la rimozione completa del numero dalla sua registrazione WhatsApp attuale in modo che possa essere registrato nuovamente su WhatsTeam.
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.
Se il numero era anche utilizzato sull'app mobile WhatsApp o WhatsApp Business:
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.
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.
Prima di connetterti tramite la Coesistenza, disabilita tutte le funzionalità di risposta automatica nella tua WhatsApp Business app:
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.
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.
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.
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.
Se preferisci creare il tuo WhatsApp Business Account direttamente tramite Meta prima di connetterti a WhatsTeam, puoi farlo tramite Meta Business Suite.
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.
Dopo il collegamento, verifica che:
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.
Prima di tentare la ri-registrazione di un numero:
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.
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.
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.
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.
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.
Questo errore indica generalmente un problema temporaneo con il servizio di verifica di Meta. Prova quanto segue:
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.
Complete guide to WhatsApp API pricing in India. INR rates for marketing, utility, and authentication messages with real cost examples.
WhatsApp Business API rates for Spain, Argentina, Mexico, and Brazil. Per-message costs, real examples, and how to optimize spend.
Confronta i prezzi di WhatsApp API e SMS fianco a fianco. Tassi di apertura, tassi di risposta, costo per conversione e quando usare ogni canale.
