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.

Jun 25, 2026

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

  1. Detecta o evento. A Meta envia um evento user_changed_number com o número antigo e o novo.
  2. Reatribui a identidade. O identificador de WhatsApp (wa_id) do contato é atualizado para o número novo.
  3. 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.
  4. Preserva a conversa. A conversa aberta continua sendo a mesma, com todas as mensagens anteriores.
  5. 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

  1. Abra a conversa do cliente na Caixa de entrada.
  2. Procure a mensagem de sistema com o ícone 📱 que mostra o número antigo e o novo.
  3. Abra o painel do contato (à direita) e confirme que o telefone já é o número novo.
  4. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp