Migrazione

Se disponi già di una configurazione del client dell'API di WhatsApp Business e desideri migrare a una nuova configurazione utilizzando lo stesso numero di telefono, questo documento ti aiuterà a identificare le modifiche da apportare e come procedere.

Prima di iniziare

• Il backup è il passaggio più importante della migrazione.
• Non è necessario ripetere la registrazione del numero di telefono dopo la migrazione. Puoi iniziare a inviare messaggi subito dopo il completamento della migrazione.
• La nuova configurazione deve avere lo stesso numero di partizioni di quella precedente. Non puoi aumentarle o ridurle durante la migrazione. Se la vecchia configurazione prevedeva un numero X di Master e un numero Y di Coreapp, la nuova configurazione deve avere lo stesso numero di Master e Coreapp. In caso di incongruenza nel numero di Master e Coreapp prima e dopo la migrazione, questa non verrà completata correttamente.
• Prova a migrare un account test prima di migrare un account di produzione.
• Prevedi un certo tempo di inattività e non inviare messaggi durante la migrazione. Indipendentemente dall'opzione di migrazione, ci sarà un determinato tempo di inattività. Ricomincia a inviare messaggi solo dopo il completamento della migrazione.

Migrazione delle impostazioni

La migrazione delle impostazioni del client WhatsApp Business preserva le impostazioni dell'app, le informazioni di registrazione e le chiavi di crittografia. Le informazioni relative ai messaggi e ai token di autenticazione non vengono migrate.

Poiché la quantità di dati da trasferire tra le macchine è minima, il tempo di inattività è molto breve.

Passaggio 1: installazione di una nuova configurazione

Configura il tuo nuovo client dell'API di WhatsApp Business seguendo la documentazione relativa all'installazione.

Passaggio 2: ottenimento di un nuovo token di autenticazione per la nuova configurazione

Il token di autenticazione corrente non sarà valido nel nuovo ambiente. Accedi alla nuova configurazione per ottenere un nuovo token di autenticazione.

Passaggio 3: pulizia

• [Opzionale] Disabilita l'autenticazione a due fattori. Questa operazione è utile se hai dimenticato il codice di autenticazione a due fattori e hai bisogno di ripetere la registrazione. Sebbene non sia necessario ripetere la registrazione per una migrazione senza problemi, potresti essere obbligato a farlo qualora non fosse possibile effettuare il backup e il ripristino per cause sconosciute. Segui le istruzioni per disabilitare il codice di autenticazione a due fattori.
  Nota: se hai la certezza che il tuo codice di autenticazione a due fattori è corretto, puoi saltare questo passaggio.
• [Opzionale] Reimposta tutti i webhook. Se la funzione webhook è configurata per ricevere notifiche in entrata e il server dei webhook viene cambiato durante la migrazione, disabilita il vecchio server nelle Impostazioni dell'app.
  Nota: questo passaggio è opzionale se non hai intenzione di cambiare server dei webhook dopo la migrazione.

Passaggio 4: esecuzione del backup delle impostazioni dalla configurazione corrente

Usa il token di autenticazione corrente per eseguire il backup dei dati delle impostazioni dal client dell'API di WhatsApp Business corrente.

Passaggio 5: disinstallazione della configurazione corrente

Questa operazione implica un tempo di inattività della messaggistica. Per ridurlo al minimo, assicurati che il client dell'API di WhatsApp Business sia pronto per l'esecuzione nella nuova posizione. Fai riferimento alla sezione Disinstallazione della relativa Guida all'installazione per le istruzioni. Assicurati di disinstallare solo il client dell'API di WhatsApp Business che include i contenitori Docker di Coreapp, Webapp e Master; non eliminare il database.

Passaggio 6: ripristino delle impostazioni nella nuova configurazione

Effettua l'accesso se non stai ancora utilizzando un nuovo token di autenticazione, quindi esegui un ripristino sulla nuova configurazione.
Il tuo nuovo client dell'API di WhatsApp Business dovrebbe essere in esecuzione con tutte le informazioni richieste ed essere pronto per la messaggistica. La cosa più importante da ricordare è che non è necessario ripetere la registrazione dell'account WhatsApp se il backup e il ripristino delle impostazioni vengono eseguiti correttamente.

Passaggio 7: esecuzione di un controllo integrità

Esegui un controllo integrità e invia un messaggio di prova per verificare che il client dell'API di WhatsApp Business funzioni.

Passaggio 8: [Opzionale] abilitazione della verifica a due fattori

Se l'hai disabilitata al Passaggio 3, abilita nuovamente la verifica a due fattori. Questa opzione offre una sicurezza aggiuntiva al tuo account WhatsApp.

Passaggio 9: configurazione dei webhook

Configura i webhook in modo da abilitare le notifiche in entrata.

Passaggio 10: eliminazione del vecchio database

Il vecchio database contiene i dati di impostazioni, messaggi e token di autorizzazione precedenti. Se desideri recuperare questi dati in futuro, non eliminare il vecchio database. Se decidi di eliminare il database, assicurati che il client dell'API di WhatsApp Business sia stato in esecuzione per almeno 14 giorni e che la messaggistica funzioni correttamente prima di eliminarlo.