¿Por qué vemos diferencias entre los números reales de marcación y el registrado en WhatsApp, para las regiones Brasil y México?

¿Qué es un ID de WhatsApp?

Cada número registrado en la aplicación de consumo de WhatsApp (IOS/Android) está asociado a un ID de WhatsApp. Los ID de WhatsApp son necesarios para enviar mensajes. Normalmente, el ID de WhatsApp tiene el mismo formato de marcación de la línea telefónica. Por ejemplo, el ID de WhatsApp del número "+1-631-555-1002" será "+16315551002".

El plan de numeración telefónica brasileño utiliza un código de área de dos dígitos más un código de ocho dígitos para las líneas fijas locales y de nueve dígitos para las líneas móviles.

Los números de teléfono móvil brasileños suelen tener ahora nueve dígitos, pero en los primeros años eran habituales siete dígitos, y posteriormente los ocho dígitos se convirtieron en la norma durante varios años.

Con el aumento del uso de las líneas móviles, se hizo evidente la escasez de números móviles disponibles. Para superar esto, el 10 de diciembre de 2010, ANATEL anunció la inclusión de un noveno dígito (en el formato 9NNN-NNN) a los números de teléfono móvil.

El dígito "9" se añadió gradualmente a la izquierda de todos los números de móvil existentes en diferentes regiones de Brasil, independientemente de sus dígitos originales. Así, por ejemplo, el número de móvil +55 (11) 8765-4321 se convirtió en +55 (11) 98765-4321.

A pesar de este hecho, los teléfonos móviles registrados fuera de las zonas 11-19 (São Paulo), 21, 22, 24 (Río de Janeiro) y 27-28 (Espírito Santo) suelen aparecer en WhatsApp con el antiguo estándar de 8 dígitos, debido a que los ID de WhatsApp ya estaban presentes para esos números antes de la inclusión del dígito "9".
Del mismo modo, México también ha implementado los siguientes cambios en sus reglas de marcación que afectan a los usuarios de WhatsApp. Al llamar a un teléfono celular mexicano desde fuera de México, ya no se requiere el dígito adicional "1" después del código de país. Esta disposición causó inconsistencias entre los números de teléfono registrados en WhatsApp y sus identificaciones reales.

¿Cuál es el impacto del código de marcación y el número de teléfono registrado en WhatsApp al utilizar las APIs de negocios de WhatsApp?

Conversaciones iniciadas por empresas

Considera una conversación iniciada por un negocio con un usuario con el número de teléfono +55 (35) 98765-4321 que ha optado por recibir mensajes en WhatsApp.
Utilizando la API de envío de mensajes de Gupshup, el negocio envía mensajes al usuario y crea una conversación C1 con +5535987654321.
Gupshup regresa un id de mensaje a la empresa para seguir el estado del mensaje.
Gupshup utiliza la API de verificación de contactos de WhatsApp para comprobar si el número de teléfono está presente en WhatsApp antes de enviar el mensaje. Esta API regresa el id de WhatsApp (wa_id) si el número de teléfono está presente en WhatsApp. En este caso, es +553587654321
Gupshup utiliza el id de WhatsApp (wa_id) +553587654321 para enviar el mensaje al usuario, pero la empresa no es consciente de que el mensaje se envió al número sin el prefijo 9.
El evento de entrega tiene un id de mensaje, por lo que es más fácil para las empresas saber si el mensaje fue entregado.
Cuando el usuario responde al mensaje, Gupshup envía un mensaje de entrada con el número de teléfono como +553587654321 (que es el mismo que el id de Whatsapp)
Como la empresa no sabe que se trata del mismo usuario +5535987654321, crea una nueva conversación C2 con +553587654321

El usuario inició una conversación

Supongamos que el usuario inicia la conversación. Gupshup envía el mensaje de entrada con el número de teléfono que coincide con el id de Whatsapp. Con esto, pueden optar por ese número también y continuar la conversación con el usuario.

Solución:

Enviaremos un evento de incompatibilidad siempre que el wa_id sea diferente al número de teléfono mencionado en la solicitud de la API, a continuación, se muestra el payload para el mismo:

{
    "app": "DemoApp",
    "timestamp": 1638607221146,
    "version": 2,
    "type": "message-event",
    "payload": {
        "id": "499a3642-5d41-477f-8bdc-58985e9c6996",
        "type": "mismatch",
        "destination": "5535987654321",
        "payload": {
            "phone": "553587654321",
            "wa_id": "5593587654321"
        }
    }
}

Este evento ayudará a los negocios a gestionar sus conversaciones de forma más eficaz y se recibirá en el webhook del negocio siempre que el destino en la solicitud de la API no coincida con el id de WhatsApp, que es el número de teléfono real registrado en WhatsApp.

Gupshup también añadirá de forma proactiva el id de WhatApp (número de teléfono sin prefijo) a la lista de registros del negocio.

Para mayor claridad consulta el diagrama de secuencia que se muestra a continuación:

¿Qué es un ID de WhatsApp?