Migrazione dei numeri di telefono tra account WhatsApp Business tramite l'iscrizione integrata

Questo documento descrive come usare l'iscrizione integrata per migrare i numeri di telefono aziendali da un account WhatsApp Business (WABA) ad un altro.

I clienti possono migrare i loro numeri di telefono aziendali tra account WhatsApp Business (WABA) e conservare i nomi visualizzati, le valutazioni di qualità, i limiti dei modelli di messaggi, gli stati dell'account business ufficiale e i modelli approvati di alta qualità. La migrazione di solito viene effettuata solo quando un cliente vuole spostare il proprio numero di telefono aziendale da un partner di soluzioni ad un altro.

Per effettuare una migrazione per un cliente, hai due opzioni: migrazione tramite iscrizione integrata o migrazione programmatica.

La migrazione tramite l'iscrizione integrata è più semplice ed è la soluzione preferita perché può essere avviata dai tuoi clienti, genera e assegna automaticamente la proprietà di tutte le risorse necessarie, concede alla tua app l'accesso a tali risorse e richiede meno chiamate API.

La migrazione programmatica deve essere avviata da te e comporta più chiamate API, poiché devi verificare che le risorse dipendenti siano configurate correttamente, devi generare tutte le nuove risorse richieste e devi associarle ad altre risorse. Per questo motivo, la migrazione programmatica è consigliata solo se collaborerai con il cliente utilizzando il modello On-Behalf-Of (ovvero, creerai e possederai l'account WhatsApp Business di destinazione e le relative risorse e li condividerai con il cliente).

Se desideri migrare i numeri di telefono dei clienti in modo programmatico, consulta il nostro documento Migrazione dei numeri di telefono tra account WhatsApp Business programmaticamente.

Come funziona

I clienti possono usare la tua implementazione dell'iscrizione integrata (versione 2) per iniziare il processo di migrazione. L'iscrizione integrata chiederà ai clienti il loro numero di telefono aziendale e un nuovo account WhatsApp Business (WABA) di destinazione.

Quando il cliente completa il flusso, l'iscrizione integrata genera il suo nuovo account WhatsApp Business, lo associa all'account business Meta, concede alla tua app l'accesso all'account WhatsApp Business, quindi restituisce il nuovo ID dell'account WhatsApp Business e l'ID del numero di telefono aziendale.

Devi acquisire questi ID e usarli con l'API per condividere la tua linea di credito, iscriverti ai webhook e registrare il numero da usare con l'API Cloud. Una volta completato il passaggio finale (registrazione), il numero di telefono aziendale viene riassociato all'account WhatsApp Business di destinazione e il numero può quindi essere utilizzato per inviare e ricevere nuovamente messaggi.

Poiché il numero di telefono aziendale del cliente non cambia, il nome visualizzato, la valutazione della qualità, il limite dei messaggi e lo stato dell'account business ufficiale sono tutti mantenuti.

Inoltre, tutti i modelli idonei sono duplicati automaticamente nell'account WhatsApp Business di destinazione e vengono assegnati loro gli stessi stati delle controparti di origine ed è possibile continuare a utilizzare tutti i contenuti multimediali caricati sul numero di telefono aziendale del cliente.

Account WhatsApp Business

L'iscrizione integrata genera automaticamente il nuovo account WhatsApp Business del cliente, lo associa al suo account business Meta e concede alla tua app l'accesso all'account WhatsApp Business.

Modelli

I modelli sono automaticamente duplicati nell'account WhatsApp Business di destinazione e vengono assegnati loro le stesse valutazioni di qualità e gli stessi stati delle controparti di origine.

Sono idonei per la duplicazione solo i modelli con uno statusAPPROVED e un quality_scoreGREEN. Se l'account WhatsApp Business di destinazione non può accettare tutti i nuovi modelli, ne duplicheremo il maggior numero possibile, fino al raggiungimento del limite di modelli dell'account di destinazione. I messaggi non duplicati devono essere ricreati e inoltrati per l'approvazione se devono essere utilizzati dall'account WhatsApp Business di destinazione.

Fatturazione

I messaggi inviati prima del completamento della migrazione vengono addebitati al vecchio partner di soluzioni. I messaggi non consegnati inviati prima che la migrazione sia completa saranno addebitati al vecchio partner di soluzioni se vengono consegnati dopo il completamento della migrazione.

I messaggi inviati dopo il completamento della migrazione sono addebitati al nuovo partner di soluzioni.

Tempo di inattività

Il tempo di inattività non inizia fino a quando non si esegue il passaggio finale (registrazione). Fino ad allora, il numero di telefono aziendale può essere usato per inviare e ricevere messaggi senza interruzioni.

Una volta eseguito il passaggio finale di registrazione, inizia il tempo di inattività, che dura fino a quando non completiamo la duplicazione dei modelli.

Una volta completato questo processo, il numero di telefono aziendale potrà essere nuovamente usato per inviare e ricevere messaggi, che saranno associati al nuovo account WhatsApp Business del cliente.

Rate limiting

La duplicazione dei modelli attivata automaticamente nell'ambito della procedura di migrazione non viene conteggiata ai fini del rate limiting. Le chiamate API che esegui, tuttavia, vengono conteggiate ai fini del rate limiting.

Limitazioni

• I numeri di telefono aziendali di prova rilasciati da WhatsApp non possono essere sottoposti a migrazione.
• I numeri di telefono aziendali migrati possono essere registrati solo per l'uso con l'API Cloud.
• La cronologia dei messaggi e i contenuti multimediali caricati non verranno migrati se l'account WhatsApp Business di origine è sull'API On-Premises.
• I numeri di telefono aziendali devono avere un nome visualizzato approvato (name_status è APPROVED).
• I numeri di telefono aziendali non possono avere richieste di modifica del nome visualizzato in sospeso.

Requisiti

Clienti

Chiedi al cliente titolare del numero di telefono aziendale di confermare che soddisfa i seguenti requisiti. Può farlo usando il Business Manager di Meta, se possiede il proprio account WhatsApp Business, accedendo ad Account WhatsApp > (nome dell'account WhatsApp Business) > Impostazioni. Se non possiede il proprio account WhatsApp Business, deve chiedere al suo fornitore di servizi business di confermare.

• Il suo account business di Meta deve avere lo stato verificato.
• Il suo account WhatsApp Business esistente deve avere lo stato approvato.
• AL suo account WhatsApp Business esistente deve essere associato un metodo di pagamento valido (in Impostazioni di pagamento).
• La verifica in due passaggi sul numero di telefono aziendale deve essere disabilitata. I clienti che possiedono il proprio account WhatsApp Business possono usare WhatsApp Manager per disabilitare la verifica in due passaggi sul numero, altrimenti devono chiedere al loro fornitore di soluzioni di disabilitarla.

Fornitori di soluzioni

Almeno un'app deve essere già iscritta ai webhook sull'account WhatsApp Business di destinazione (consulta Webhook) e devi usare la versione 2 dell'iscrizione integrata con la registrazione delle sessioni abilitata.

Passaggi di migrazione

Passaggio 1: chiedi al cliente di disabilitare la verifica in due passaggi

Se non l'hai ancora fatto, chiedi al cliente di usare WhatsApp Manager per disabilitare la verifica in due passaggi sul suo numero di telefono aziendale (o di chiedere al suo attuale fornitore di soluzioni di disabilitarla).

Non puoi completare i passaggi rimanenti finché la verifica in due passaggi non sarà disabilitata.

Passaggio 2: implementa l'iscrizione integrata

Indica il cliente ad accedere alla tua implementazione dell'iscrizione integrata (versione 2) e di fornire il suo numero di telefono aziendale e il suo nome visualizzato quando richiesto nel flusso.

Passaggio 3: acquisisci gli ID delle risorse

Quando il cliente completa il flusso, acquisisci l'ID del numero di telefono aziendale e il nuovo account WhatsApp Business restituito nel payload.

Passaggio 4: condividi la tua linea di credito

Condividi la tua linea di credito con l'account WhatsApp Business proprio come faresti normalmente dopo aver registrato un cliente tramite l'iscrizione integrata.

Passaggio 5: iscriviti ai webhook

Iscrivi la tua app ai webhook sul nuovo account WhatsApp Business del cliente.

Passaggio 6: registra il numero di telefono per l'API Cloud

Registra il numero di telefono aziendale da usare con l'API Cloud (non puoi registrare un numero di telefono aziendale migrato da usare con l'API On-Premises).