Trocar o número de telefone em uma conexão Coexistência
Uma conexão Coexistência pertence a um único número de telefone. Quando a empresa troca o número no app do WhatsApp Business, a Meta desconecta a conexão com o motivo CHANGE_NUMBER. O novo número é outro número de telefone comercial na plataforma e precisa passar pelo fluxo de Coexistência como uma nova conexão.
O motivo de desconexão que a Meta informa quando a empresa trocou o número de telefone.
Limite inicial de números de telefone comerciais registrados em um novo portfólio de negócios, ampliado depois para 20.
Um número usado para enviar mensagens pagas dentro deste período não pode ser excluído da plataforma.
O que acontece com a conexão quando o número muda?
Ela termina. A Meta inclui a troca de número de telefone entre os motivos de desconexão de uma conexão Coexistência e a informa no disconnection_info do webhook account_update, com o motivo CHANGE_NUMBER.
Isso é a plataforma sendo coerente, não rígida. Tudo o que o lado da API conhece está vinculado a um número de telefone comercial: o phone number ID, o nome de exibição, a classificação de qualidade e as assinaturas de webhook. Outro número é outro ativo, então nada do que estava ligado ao antigo se move sozinho, e a conexão antiga deixa de funcionar no momento da troca.
Como conecto o novo número?
Como uma primeira conexão. O novo número precisa cumprir as mesmas condições de qualquer número que entra na Coexistência e depois passar pelo onboarding desde o início. Nada da conexão antiga é reaproveitado, então vale tratar a troca como um pequeno projeto com data marcada.
- Estar ativo no app do WhatsApp Business, na versão 2.24.17 ou mais recente.
- Estar em um Portfólio de Negócios que você administra.
- Não estar vinculado a outro provedor.
- Ter o nome de exibição informado no registro, como em qualquer número de telefone comercial.
O que deve ser atualizado no lado da API?
Todos os lugares em que o número antigo ou o ID dele estão guardados. As integrações que enviam pela Cloud API endereçam um phone number ID, então um CRM, um fluxo de automação ou um agente de IA que ainda aponte para o ID antigo vai falhar em vez de migrar.
A nova conexão também repete as perguntas do onboarding, incluindo se o histórico de conversas será compartilhado e a janela de 24 horas para sincronizá-lo. O destino de webhook configurado na conexão antiga precisa ser aplicado à nova. Vale conferir também a capacidade do portfólio: a Meta limita um novo portfólio de negócios a dois números de telefone comerciais registrados até que ele seja verificado ou alcance um limite de 2,000 mensagens.
O que acontece com o número antigo na plataforma?
Ele continua como um ativo na conta do WhatsApp Business até que alguém o remova. A Meta só permite que administradores do portfólio de negócios excluam números de telefone comerciais e recusa a exclusão de um número usado para enviar mensagens pagas nos últimos 30 dias.
Excluir é uma arrumação opcional, não um requisito para conectar o novo número, mas deixar números antigos na conta facilita que um sistema continue endereçando o número errado. Removê-lo depois que os 30 dias passarem mantém a conta legível.
Erros comuns
- Trocar o número no app antes de planejar a reconexão. A conexão antiga termina nesse momento.
- Deixar o phone number ID antigo nas integrações. Os envios falham em vez de seguir o novo número.
- Tentar excluir o número antigo logo após a troca. A Meta bloqueia se ele enviou mensagens pagas em 30 dias.
A EasyCoexistence mostra uma desconexão CHANGE_NUMBER na linha do tempo da conexão exatamente como a Meta a informa, e o novo número se conecta pelo mesmo Embedded Signup de autoatendimento em cerca de dois minutos.
Perguntas frequentes
A conexão acompanha o meu novo número?
Não. A Meta a desconecta com o motivo CHANGE_NUMBER, e o novo número é conectado como uma nova conexão.
Preciso de um novo phone number ID?
Sim. O novo número é um número de telefone comercial separado na plataforma, com ID próprio.
Posso excluir o número antigo imediatamente?
Só se ele não tiver enviado mensagens pagas nos últimos 30 dias, e somente um administrador do portfólio pode excluí-lo.
Preciso escolher o nome de exibição de novo?
Sim. A Meta exige as informações do nome de exibição quando um número de telefone comercial é registrado.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em