Como migrar um número de telefone comercial entre parceiros de soluções via cadastro incorporado
Este documento descreve como usar o cadastro incorporado para migrar números de telefone comercial entre parceiros de soluções e entre contas do WhatsApp Business (WABA, pelas iniciais em inglês).
Os clientes podem migrar números de telefone comercial entre Contas do WhatsApp Business e manter o nome de exibição, a classificação de qualidade, o limite de mensagens de modelo, o status de conta comercial oficial, além dos modelos aprovados com alta qualidade. Normalmente, a migração só é realizada quando um cliente deseja migrar o número de telefone comercial de um parceiro de solução para outro.
Há duas formas de migrar o número de um cliente: via Cadastro Incorporado ou migração programática.
A migração via Cadastro Incorporado é a opção mais simples e a solução preferencial. Isso porque ela pode ser iniciada pelos clientes, gera e concede automaticamente a propriedade de todos os ativos necessários, concede ao seu app acesso a esses ativos e exige menos chamadas de API.
Já a migração programática deve ser iniciada por você e envolve mais chamadas de API. Nesse processo, você precisa verificar se os ativos dependentes estão configurados da forma correta, bem como gerar todos os novos ativos necessários por conta própria e associá-los a outros ativos. Por esse motivo, a migração programática só será recomendada caso você trabalhe com o cliente usando o modelo "em nome de" (ou seja, você criará e terá a propriedade da WABA de destino e dos respectivos ativos e os compartilhará com o cliente).
Se você quiser migrar os números de telefone dos clientes de forma programática, consulte o documento Migrating Numbers Between WhatsApp Business Accounts Programmatically.
Como funciona
Os clientes podem usar sua implementação do Cadastro Incorporado (versão 2) para iniciar o processo de migração. O Cadastro Incorporado solicitará aos clientes o número de telefone comercial e uma nova conta do WhatsApp Business de destino.
Quando o cliente conclui o fluxo, o Cadastro Incorporado gera a nova conta do WhatsApp Business, associa-a ao respectivo portfólio empresarial da Meta, concede ao seu app acesso à WABA e, depois, retorna a identificação da WABA recém-criada e do número de telefone comercial.
Você precisa armazenar esses números de identificação e usá-los com a API a fim de compartilhar sua linha de crédito, assinar webhooks e registrar o número para uso com a API de Nuvem. Depois de concluir a etapa final (registro), o número de telefone comercial será reassociado à WABA de destino e poderá ser usado para enviar e receber mensagens novamente.
Como não há alteração no número de telefone comercial do cliente, mantemos o nome de exibição, a classificação de qualidade, o limite de mensagens e o status de conta comercial oficial.
Todos os modelos qualificados são duplicados automaticamente na WABA de destino e recebem o mesmo status que os equivalentes de origem. Além disso, é possível continuar usando todas as mídias carregadas no número de telefone comercial do cliente.
Contas do WhatsApp Business
O Cadastro Incorporado gera automaticamente a nova WABA do cliente, associa-a à respectiva conta empresarial da Meta e concede ao seu app acesso à WABA.
Modelos
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.
Cobrança
- 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 de inatividade do modelo
O registro de número de telefone comercial acontece instantaneamente, portanto, você poderá continuar enviando e recebendo mensagens sem interrupções.
Porém, a duplicação de modelos leva tempo. Por isso, você não poderá usar os modelos afetados até que eles sejam migrados.
Para evitar essa inatividade, você pode começar a migração dos modelos antes de registrar o número de telefone.
Limites de volume
A duplicação de modelos disparada automaticamente como parte do processo de migração não tem impacto no limite de volume. No entanto, as chamadas de API realizadas por você serão contabilizadas no limite.
Limitações
- Os números de telefone comercial de teste emitidos pelo WhatsApp não podem ser migrados.
- Os números de telefone comercial migrados só podem ser registrados para uso com a API de Nuvem.
- Não faremos a migração do histórico de mensagens nem das mídias carregadas se a WABA de origem estiver na API Local.
- Os números de telefone comercial devem ter um nome de exibição aprovado (
name_statuséAPPROVED). - Os números de telefone comercial não podem ter solicitações pendentes de alteração do nome de exibição.
- As classificações dos modelos NÃO serão migradas. Todos os modelos migrados terão a classificação inicial definida como
UNKNOWN. Essa classificação será mantida nas primeiras 24 horas. Após esse período, uma nova classificação será gerada se houver dados suficientes disponíveis.
Requisitos
Clientes
Peça para o cliente proprietário do número de telefone comercial confirmar se ele atende aos requisitos a seguir. Para isso, ele pode abrir o Gerenciador de Negócios da Meta (caso seja o proprietário da WABA) e acessar Contas do WhatsApp > (nome da WABA do cliente) > Configurações. Se ele não for o proprietário da WABA, será preciso solicitar a confirmação do parceiro de solução.
- A conta empresarial do cliente na Meta precisa ter o status de verificada.
- A WABA existente deve ter o status de aprovada.
- A WABA existente deve ter uma forma de pagamento válida anexada em Configurações de pagamento.
- A confirmação em duas etapas do número de telefone comercial precisa estar desabilitada. Os clientes que forem os proprietários das WABAs poderão usar o Gerenciador do WhatsApp para desabilitar a confirmação em duas etapas nos respectivos números de telefone. Caso contrário, eles precisarão solicitar aos parceiros de soluções que realizem essa ação.
Parceiros de soluções
É preciso que pelo menos um app já tenha assinado webhooks na WABA de destino (consulte Webhooks). Além disso, você deve usar a versão 2 do Cadastro Incorporado com o registro da sessão habilitado.
Etapas de migração
Etapa 1: instruir o cliente a desabilitar a confirmação em duas etapas
Caso ainda não tenha feito isso, oriente seu cliente a usar o Gerenciador do WhatsApp para desabilitar a confirmação em duas etapas no número de telefone comercial (ou diga para ele pedir ao parceiro de solução atual que desabilite o recurso).
Não será possível concluir os próximos passos até que a confirmação em duas etapas seja desabilitada.
Etapa 2: exibir o Cadastro Incorporado
Oriente o cliente a acessar sua implementação do Cadastro Incorporado (versão 2) e a fornecer o número de telefone comercial e o nome de exibição associado durante o fluxo.
Etapa 3: capturar IDs de ativos
Quando o cliente concluir o fluxo, capture o ID do número de telefone comercial e a nova WABA retornados no evento de mensagem.
Etapa 4: compartilhar sua linha de crédito
Compartilhe sua linha de crédito com a WABA como você faria normalmente depois de integrar um cliente por meio do cadastro incorporado.
Etapa 5: assinar webhooks
Assine webhooks para seu app na nova WABA do cliente.
Etapa 6: registrar o número de telefone na API de Nuvem
Registre o número de telefone comercial para uso com a API de Nuvem. Não é possível registrar um número migrado para uso com a API Local.
Solução de problemas
Se a migração do modelo falhar, consulte a documentação a seguir para obter instruções sobre como disparar manualmente esse processo: Migração de modelo.