Qué ocurre cuando un contacto cambia su número de WhatsApp

Cuando un cliente migra su cuenta de WhatsApp a un número nuevo, Omnifox actualiza el contacto y conserva toda la conversación de forma automática.

Jun 25, 2026

Qué es

Cuando uno de tus clientes pasa su cuenta de WhatsApp a un número de teléfono distinto, Meta avisa a Omnifox con un evento de sistema. Omnifox migra automáticamente la identidad del contacto al número nuevo y conserva toda la conversación: no se crea un contacto duplicado ni se pierde el historial.

Este artículo explica qué verás en la Bandeja de entrada y qué hacer (casi siempre, nada).

Cuándo aplica

  • El cliente conserva su cuenta de WhatsApp pero la asocia a otro número (cambio de chip, portabilidad, etc.).
  • El canal de WhatsApp de tu workspace está conectado vía API de Meta (Cloud API o Coexistence).

Qué hace Omnifox automáticamente

  1. Detecta el evento. Meta envía un evento user_changed_number con el número anterior y el nuevo.
  2. Reasigna la identidad. El identificador de WhatsApp (wa_id) del contacto se actualiza al nuevo número.
  3. Fusiona duplicados. Si ya existía otro contacto con el número nuevo, Omnifox los fusiona: re-vincula las conversaciones, las identidades y los campos personalizados, y deja un registro de la fusión.
  4. Conserva la conversación. La conversación abierta sigue siendo la misma, con todos los mensajes anteriores.
  5. Deja un mensaje de sistema dentro del chat, por ejemplo: "📱 El cliente cambió su número de WhatsApp de +593… a +593…", para que el agente tenga trazabilidad.

Cómo verificarlo

  1. Abre la conversación del cliente en Bandeja de entrada.
  2. Busca el mensaje de sistema con el ícono 📱 que indica el número anterior y el nuevo.
  3. Abre el panel del contacto (a la derecha) y confirma que el número de teléfono ya es el nuevo.
  4. Comprueba que el historial anterior sigue visible en el mismo hilo.

Si no funciona

  • No veo el mensaje de sistema: Meta solo envía el evento si el cliente migró la misma cuenta a otro número. Si abrió una cuenta nueva desde cero, llegará como un contacto nuevo (sin historial), porque para Meta es otra persona.
  • Aparecen dos contactos separados: ocurre si el número viejo no era localizable en el momento del evento. Puedes unirlos manualmente desde el contacto con la acción de fusionar contactos.
  • Historial antiguo no migrado (canales con Coexistence): un administrador puede reconciliar cambios pasados con el comando whatsapp:fix-changed-numbers, que aplica la misma lógica de migración a eventos históricos.

Consejos

  • No edites el número del contacto a mano cuando llegue el aviso: Omnifox ya lo actualizó. Editar en paralelo puede crear inconsistencias.
  • La fusión es definitiva. Antes de fusionar manualmente dos contactos, revisa que de verdad sean la misma persona.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp