Come Migrare alla WhatsApp Business API

Questa guida ti accompagna nel processo di migrazione del tuo numero WhatsApp esistente alla WhatsApp Business API ufficiale utilizzando WhatsTeam. La migrazione ti consente di utilizzare le funzionalità avanzate dell'API mantenendo il tuo numero attuale e la cronologia delle chat.

Vantaggi della Migrazione

La migrazione alla WhatsApp Business API offre diversi vantaggi chiave:

Nessun Rischio di Ban

L'integrazione ufficiale con la WhatsApp API elimina il rischio di ban e disconnessioni che possono verificarsi con metodi non ufficiali.

Mantieni la Cronologia delle Chat

Continua ad avere accesso a tutte le tue chat e contatti sia sull'app mobile che su WhatsTeam. La cronologia delle conversazioni viene preservata durante la migrazione.

Mantieni il Numero Attuale

Continua a utilizzare la tua app mobile WhatsApp Business sfruttando contemporaneamente l'API ufficiale. Non è necessario registrare un nuovo numero.

Configurazione Semplice

Completa la migrazione in pochi minuti con il nostro semplice processo guidato. Non è richiesta alcuna competenza tecnica.

Requisiti

Prima di iniziare la migrazione, assicurati di soddisfare i seguenti requisiti:

1. WhatsApp Business App

Devi utilizzare la WhatsApp Business App (non la WhatsApp personale) sul tuo telefono. Se attualmente utilizzi l'app WhatsApp personale, dovrai prima migrare a WhatsApp Business (vedi la sezione Pre-Migrazione qui sotto).

2. Account Facebook

Hai bisogno di un account Facebook attivo collegato alla tua attività. Questo è necessario per il processo di autenticazione Meta.

3. Accesso al Telefono Cellulare

Avrai bisogno del tuo telefono cellulare durante la migrazione per collegare il tuo numero WhatsApp Business attuale.

Suggerimento: Il processo di configurazione del numero è semplice e può essere completato in pochi minuti seguendo i passaggi di onboarding.

Pre-Migrazione: Da App Personale a Business

Salta questa sezione se stai già utilizzando la WhatsApp Business App.

Se attualmente utilizzi l'app WhatsApp personale, devi prima migrare alla WhatsApp Business App prima di procedere con la migrazione all'API.

Segui questi passaggi per migrare da WhatsApp personale a WhatsApp Business:

Passaggio 1: Esegui il backup della cronologia delle chat

Apri WhatsApp sul tuo telefono e crea un backup della cronologia delle chat:

1. Vai su Impostazioni > Chat > Backup delle Chat
2. Tocca Esegui Backup Adesso
3. Attendi il completamento del backup

Passaggio 2: Scarica WhatsApp Business

Scarica l'app WhatsApp Business dallo store del tuo dispositivo:

• Scarica per Android (Google Play)
• Scarica per iOS (App Store)

Passaggio 3: Verifica il tuo numero

Apri WhatsApp Business e verifica il tuo numero di telefono:

1. Apri l'app WhatsApp Business
2. Accetta i Termini di Servizio
3. Inserisci il tuo numero di telefono
4. Verifica con il codice SMS

Come verificare il tuo numero su WhatsApp Business (FAQ WhatsApp)

Passaggio 4: Ripristina il backup delle chat

Quando richiesto, ripristina la cronologia delle chat dal backup che hai creato:

1. WhatsApp Business rileverà il tuo backup
2. Tocca Ripristina per recuperare le tue chat
3. Attendi il completamento del ripristino

Maggiori Informazioni:

• Come migrare da WhatsApp a WhatsApp Business (FAQ WhatsApp)
• Come eseguire il backup della cronologia delle chat (FAQ WhatsApp)

Limitazioni da Riconoscere

Prima di procedere con la migrazione, è importante comprendere le limitazioni operative. Le seguenti funzionalità NON saranno disponibili in WhatsTeam dopo la migrazione, ma CONTINUERANNO a funzionare sull'app mobile WhatsApp Business e su WhatsApp Web/Desktop.

1. Messaggi di Gruppo

La gestione e la messaggistica dei gruppi saranno disponibili solo tramite l'app mobile. Non è possibile inviare o ricevere messaggi di gruppo tramite l'API.

2. Messaggi dei Canali

La messaggistica dei Canali WhatsApp sarà disponibile solo tramite l'app mobile.

3. Stato Utente (Storie)

La visualizzazione e la pubblicazione degli aggiornamenti di stato saranno disponibili solo tramite l'app mobile.

4. Prezzi dei Messaggi Template

Meta addebita i messaggi template pre-approvati inviati tramite l'API. Si applicano determinate restrizioni e costi aggiuntivi per i messaggi in uscita in alcuni scenari.

5. Disconnessione dei Dispositivi Collegati

I dispositivi collegati esistenti (WhatsApp Web/Desktop) verranno disconnessi durante la migrazione. Puoi ricollegarli dopo il completamento della migrazione.

6. Processo Irreversibile

Importante: La migrazione alla WhatsApp Business API è un processo irreversibile. Una volta migrato, il numero rimarrà sulla connessione ufficiale WABA in WhatsTeam.

Maggiori Informazioni:

• Scopri di più sulle limitazioni nell'uso della WABA Cloud API (Meta Developers)

Passaggi della Migrazione

Una volta confermati i requisiti e riconosciute le limitazioni, sei pronto per iniziare la migrazione.

Passaggio 1: Avvia la Migrazione

Vai alla pagina di migrazione WABA nell'app e clicca "Iniziamo" per avviare il processo.

Passaggio 2: Verifica i Requisiti

Conferma di soddisfare tutti i requisiti e clicca "Continua".

Passaggio 3: Riconosci le Limitazioni

Leggi e riconosci ciascuna limitazione cliccando su ogni elemento. Tutte le limitazioni devono essere riconosciute per procedere.

Passaggio 4: Conferma e Avvia

Rivedi le note importanti e clicca "Avvia Migrazione" per iniziare il processo Meta Connect.

Note importanti prima di iniziare:

• Tutti i dispositivi collegati verranno disconnessi
• Puoi ricollegarli dopo il completamento della migrazione
• Segui semplicemente i passaggi nella finestra popup fino al termine
• Non chiudere la finestra durante il processo

Passaggio 5: Completa l'Autenticazione Meta

Apparirà una finestra Meta Connect. Segui i passaggi di autenticazione:

1. Accedi con il tuo account Facebook
2. Seleziona o crea il tuo WhatsApp Business Account
3. Scegli il numero di telefono da connettere
4. Completa il processo di verifica

Passaggio 6: Inserisci le Informazioni Aziendali

Quando richiesto, inserisci i dettagli della tua attività:

• Nome dell'azienda: Deve corrispondere al nome sui tuoi documenti di registrazione (importante per la futura verifica aziendale)
• Sito web: Inserisci il sito web della tua attività, oppure seleziona "La mia attività non ha un sito web" se applicabile

Passaggio 7: Inserisci il tuo Numero di Telefono

Quando richiesto, inserisci il tuo numero di telefono WhatsApp Business. Seleziona il tuo prefisso internazionale e digita il numero nel campo fornito. Questo passaggio è necessario per collegare il tuo numero alla WhatsApp Business API.

Vedrai anche un messaggio sulla connessione della tua app WhatsApp Business esistente. Questo significa che le informazioni del tuo account (come numero di telefono, contatti, chat e cronologia delle chat) potrebbero essere condivise per abilitare la migrazione. I tuoi dati saranno gestiti in modo sicuro da Meta.

Clicca Avanti per continuare.

Passaggio 8: Migrazione Completata

Una volta completato il processo, vedrai una conferma di successo. Il tuo numero è ora connesso alla WhatsApp Business API!

Chiudi la finestra di Facebook e torna alla finestra dell'app. Vedrai un messaggio di successo come questo:

Cosa Succede Dopo la Migrazione

Dopo aver migrato con successo il tuo numero:

La tua app mobile continua a funzionare normalmente

Puoi continuare a utilizzare l'app WhatsApp Business sul tuo telefono per messaggi individuali, gruppi, canali e aggiornamenti di stato.

I messaggi sono sincronizzati

I messaggi sono sincronizzati tra la piattaforma e il tuo telefono. I messaggi inviati tramite l'API appaiono nella tua WhatsApp Business App, e i messaggi ricevuti sul telefono appaiono nell'app.

Le funzionalità avanzate sono ora disponibili

Ora puoi utilizzare:

• Campagne di messaggistica massiva
• Chatbot e flussi automatizzati
• Collaborazione nella casella di posta del team
• Integrazioni API
• Modelli di messaggio
• Analisi e reportistica

Ricollega i dispositivi collegati

Se avevi WhatsApp Web o Desktop connessi, dovrai ricollegarli:

1. Apri WhatsApp Business sul tuo telefono
2. Vai su Impostazioni > Dispositivi Collegati
3. Tocca Collega un Dispositivo
4. Scansiona il codice QR su WhatsApp Web/Desktop

Risoluzione dei Problemi

Disconnessione da un Provider WABA Precedente

Se il tuo numero è già connesso a un altro Business Solution Provider (BSP), devi disconnetterlo prima di migrare a WhatsTeam. WhatsApp non supporta l'utilizzo dello stesso numero di telefono su più integrazioni contemporaneamente.

Per numeri che utilizzano la Coesistenza (WhatsApp Business App + Cloud API)

Devi disconnetterti sia da Meta Business Suite che dalla WhatsApp Business App:

Passaggio 1: Rimuovi l'accesso in Meta Business Suite

1. Accedi a Meta Business Suite con le tue credenziali aziendali
2. Clicca su Impostazioni (solitamente in basso a sinistra)
3. Nella sezione Account, clicca su Account WhatsApp
4. Seleziona la WhatsApp Business App in questione e apri la scheda Partner
5. Clicca Gestisci accanto al tuo BSP attuale
6. Nella finestra popup, clicca Rimuovi accesso

Passaggio 2: Disconnetti dalla WhatsApp Business App

1. Apri la WhatsApp Business App sul tuo telefono
2. Vai su Impostazioni > Account > Piattaforma aziendale
3. Tocca il partner/provider che vuoi disconnettere
4. Seleziona Disconnetti

Per numeri registrati esclusivamente per Cloud API (senza coesistenza)

Se il tuo numero era registrato solo per Cloud API senza la WhatsApp Business App:

1. Accedi a Meta Business Suite con le tue credenziali aziendali
2. Clicca su Impostazioni (solitamente in basso a sinistra)
3. Nella sezione Account, clicca su Account WhatsApp
4. Seleziona il WABA associato al numero che vuoi eliminare
5. Clicca WhatsApp Manager
6. Individua il numero che desideri rimuovere e clicca l'icona del cestino per eliminarlo

Nota: Dopo la disconnessione, potrebbero essere necessarie alcune ore affinché i dati si aggiornino completamente. Una volta completate le modifiche, potrai connettere il tuo numero a WhatsTeam.

Migrazione fallita o scaduta

Se la migrazione fallisce o scade:

1. Assicurati di avere una connessione internet stabile
2. Verifica che il tuo account Facebook sia in buone condizioni
3. Verifica che la tua WhatsApp Business App sia aggiornata
4. Riprova dall'inizio

Messaggi non sincronizzati

Se i messaggi non appaiono in entrambi i luoghi:

• Assicurati che la sincronizzazione sia completata
• Verifica di aver condiviso la cronologia delle conversazioni durante la configurazione
• Ricorda che i media più vecchi di 14 giorni non possono essere sincronizzati
• I nuovi messaggi dovrebbero sincronizzarsi automaticamente

Non trovo l'opzione di migrazione

L'opzione di migrazione è disponibile per i numeri che attualmente utilizzano la WhatsApp Business App e non sono ancora stati collegati all'API ufficiale. Vai a:

1. Vai alle impostazioni del tuo dispositivo in WhatsTeam
2. Cerca l'opzione "Migra a WABA"

Domande Frequenti

Posso annullare la migrazione dopo averla completata?

No. La migrazione alla WhatsApp Business API è irreversibile. Una volta che il tuo numero è collegato tramite la WABA ufficiale, non è possibile tornare a utilizzare solo la WhatsApp Business App in WhatsTeam.

Perderò i miei contatti?

No. I tuoi contatti rimangono sul tuo telefono e nella WhatsApp Business App. Anche i contatti che sono stati sincronizzati con WhatsTeam saranno preservati.

Quanto tempo richiede la migrazione?

Il processo di migrazione richiede tipicamente 5-10 minuti. La sincronizzazione dei messaggi potrebbe richiedere più tempo a seconda delle dimensioni della cronologia delle chat.

È disponibile in tutti i paesi?

La funzionalità di Coesistenza non è disponibile per le aziende in Nigeria e Sudafrica (identificate dal numero di telefono della Business App).

E riguardo alla velocità di invio dei messaggi?

I numeri che utilizzano la Coesistenza hanno una velocità fissa di 5 messaggi al secondo per rimanere compatibili con la WhatsApp Business App.