O que acontece quando um contato muda o número de WhatsApp
Quando um cliente leva a conta de WhatsApp para um número novo, o Omnifox atualiza o contato e preserva toda a conversa automaticamente.
O que é
Quando um cliente leva a conta de WhatsApp para outro número de telefone, a Meta avisa o Omnifox por meio de um evento de sistema. O Omnifox migra automaticamente a identidade do contato para o número novo e preserva toda a conversa: nenhum contato duplicado é criado e nenhum histórico é perdido.
Este artigo explica o que você verá na Caixa de entrada e o que fazer (quase sempre, nada).
Quando se aplica
- O cliente mantém a conta de WhatsApp, mas a vincula a outro número (novo chip, portabilidade, etc.).
- O canal de WhatsApp do seu workspace está conectado via API da Meta (Cloud API ou Coexistence).
O que o Omnifox faz automaticamente
- Detecta o evento. A Meta envia um evento
user_changed_numbercom o número antigo e o novo. - Reatribui a identidade. O identificador de WhatsApp (wa_id) do contato é atualizado para o número novo.
- Mescla duplicados. Se já existia outro contato com o número novo, o Omnifox os mescla: revincula conversas, identidades e campos personalizados, e grava um registro da mesclagem.
- Preserva a conversa. A conversa aberta continua sendo a mesma, com todas as mensagens anteriores.
- Deixa uma mensagem de sistema dentro do chat, por exemplo: "📱 O cliente mudou seu número de WhatsApp de +55… para +55…", para que o agente tenha rastreabilidade.
Como verificar
- Abra a conversa do cliente na Caixa de entrada.
- Procure a mensagem de sistema com o ícone 📱 que mostra o número antigo e o novo.
- Abra o painel do contato (à direita) e confirme que o telefone já é o número novo.
- Verifique se o histórico anterior continua visível no mesmo tópico.
Se não funcionar
- Não vejo a mensagem de sistema: a Meta só envia o evento quando o cliente migrou a mesma conta para outro número. Se ele criou uma conta nova do zero, ela chega como um contato novo (sem histórico), porque para a Meta é outra pessoa.
- Aparecem dois contatos separados: isso ocorre quando o número antigo não era localizável no momento do evento. Você pode uni-los manualmente a partir do contato usando mesclar contatos.
- Histórico antigo não migrado (canais com Coexistence): um administrador pode reconciliar mudanças passadas com o comando
whatsapp:fix-changed-numbers, que aplica a mesma lógica de migração a eventos históricos.
Dicas
- Não edite o número do contato manualmente quando o aviso chegar: o Omnifox já o atualizou. Editar em paralelo pode gerar inconsistências.
- A mesclagem é definitiva. Antes de mesclar dois contatos manualmente, confirme que são mesmo a mesma pessoa.
Artigos relacionados
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.