Migrazione di un numero di telefono aziendale da un partner delle soluzioni a un altro tramite l'iscrizione integrata
Questo documento descrive come usare l'iscrizione integrata per migrare i numeri di telefono aziendali da un partner delle soluzioni e account WhatsApp Business (WABA) a un altro partner delle soluzioni e WABA.
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 al portfolio business di 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
Templates are automatically duplicated in the destination WABA and initially granted the same status as their source counterparts.
After duplication however, templates are re-checked to ensure they are correctly categorized according to our guidelines. This may result in some duplicated templates having their status set to REJECTED.
Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA's template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.
Note that template quality ratings are not duplicated. All duplicated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.
Fatturazione
- messages sent before migration is complete are charged to the source Solution Partner.
- messages sent after migration is complete are charged to the destination Solution Partner.
- undelivered messages sent before migration is complete will be charged to the source Solution Partner if they are delivered after migration is complete.
Tempo di inattività del modello
La registrazione del numero di telefono aziendale avviene istantaneamente, quindi puoi continuare a inviare e ricevere messaggi senza interruzioni.
Tuttavia, la duplicazione dei modelli richiede tempo, quindi non potrai usare i modelli interessati finché non ne viene eseguita la migrazione.
Per evitare questo tempo di inattività, puoi iniziare la migrazione del modello prima della registrazione del numero di telefono.
Rate limit
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.
- Le valutazioni della qualità dei modelli NON saranno migrate. Tutti i modelli migrati inizieranno con una valutazione
UNKNOWN. Questa valutazione resterà invariata per le prime 24 ore, trascorse le quali verrà generata una nuova valutazione se i dati a disposizione sono sufficienti.
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 nell'evento del messaggio.
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).
Risoluzione dei problemi
Se il processo di migrazione dei modelli ha esito negativo, consulta la seguente documentazione per istruzioni su come attivare manualmente la migrazione di un modello: Migrazione dei modelli.