Como migrar números de telefone entre contas do WhatsApp Business via Cadastro Incorporado

Este documento descreve como usar o Cadastro Incorporado para migrar números de telefone comercial de uma conta do WhatsApp Business (WABA, pelas iniciais em inglês) para outra.

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 à respectiva conta empresarial da Meta, concede ao seu app acesso à WABA e, depois, retorna a identificação da WABA recém-criada e o ID 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

Os modelos são duplicados automaticamente na WABA de destino e recebem classificação de qualidade e status idênticos aos dos equivalentes de origem.

Apenas os modelos com status de APPROVED e quality_score de GREEN são qualificados para duplicação. Se a WABA de destino não conseguir acomodar todos os novos modelos, duplicaremos o maior número possível até que o limite de modelos da WABA de destino seja atingido. Para que a WABA de destino possa usar os modelos não duplicados, eles precisam ser recriados e enviados para aprovação.

Cobrança

As mensagens enviadas antes da conclusão da migração serão cobradas do antigo parceiro de solução. Já as mensagens não entregues que tiverem sido enviadas antes da conclusão da migração serão cobradas do antigo parceiro de solução se a entrega for realizada após a migração.

As mensagens enviadas após a conclusão da migração serão cobradas do novo parceiro de solução.

Inatividade

O tempo de inatividade só será iniciado quando você concluir a etapa final (registro). Antes disso, o número de telefone comercial poderá ser usado para enviar e receber mensagens sem interrupções.

Após o registro, o tempo de inatividade será iniciado e durará até concluirmos a duplicação de modelos.

Ao final desse processo, será possível usar o número de telefone comercial novamente para enviar e receber mensagens, que serão associadas à nova WABA do cliente.

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.

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 os IDs de ativos

Quando o cliente concluir o fluxo, capture os IDs do número de telefone comercial e da nova WABA retornados na carga.

Etapa 4: compartilhar sua linha de crédito

Compartilhe sua linha de crédito com a WABA como você faria normalmente após 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.