Por que vemos diferenças entre os números reais discáveis e o número registrado no WhatsApp no Brasil e México?

O que é um ID de WhatsApp?

Todo número registrado no aplicativo de consumidor de WhatsApp (iOS/Android) é associado a um ID de WhatsApp. Os IDs de WhatsApp são necessários para enviar mensagens. Geralmente, o ID de WhatsApp de um número fica no formato discável do próprio número. Por exemplo, o ID de WhatsApp do número "+1-631-555-1002" será "+16315551002".

O sistema de números brasileiro usa um código de área de dois dígitos mais um número local de oito números (para telefones fixos) e de nove dígitos (para telefones móveis).

Os números brasileiros costumam ter nove dígitos hoje em dia, mas era comum usarem sete dígitos nos primeiros anos; depois, o formato de oito dígitos se tornou padrão por vários anos.

Com o aumento no número de linhas móveis, ficou evidente que não haveria suficientes números disponíveis. Para superar o problema, a ANATEL anunciou em 10 de dezembro de 2010 a inclusão de um nono dígito (no formato 9NNNN-NNNN) aos números de telefones móveis.

O dígito 9 foi gradualmente adicionado como prefixo a todos os números móveis existentes nas diferentes regiões do Brasil, independentemente dos dígitos iniciais antigos. Assim, por exemplo, o número de celular +55 (11) 8765-4321 virou +55 (11) 98765-4321.

Apesar desse fato, os números móveis registrados fora das áreas 11-19, 21, 22, 24 (Rio de Janeiro) e 27-28 (Espírito Santo) são geralmente exibidos no WhatsApp com o antigo formato de 8 dígitos, dado que os IDs de WhatsApp já existiam para esses números desde antes da inclusão do dígito 9.

Da mesma forma, o México também implementou as mudanças a seguir em suas regras de discagem que afetam usuários do WhatsApp. Ao ligar de fora do México para um número de celular mexicano, o dígito adicional 1 após o código do país não é mais necessário. Essencialmente, isso gera inconsistências entre os números registrados no WhatsApp e os IDs de WhatsApp reais.

Qual é o impacto do código de discagem e o número registrado no WhatsApp no uso das APIs de WhatsApp?

Conversas iniciadas pelo negócio

Considere a primeira conversa iniciada por uma empresa com usuário com número de celular +55 (35) 98765-4321 que optou por receber mensagens no WhatsApp.
Usando a API de envio de mensagens da Gupshup, o negócio envia mensagens ao cliente e cria uma conversa C1 com +5535987654321.
A Gupshup fornece um ID de mensagem para que o negócio possa acompanhar o status da mensagem.
A Gupshup usa a API de verificação de contato do WhatsApp para conferir se o número de telefone está presente no WhatsApp antes de enviar a mensagem. Esta API responde com o ID de WhatsApp (wa_id) caso o número esteja presente no WhatsApp. Neste caso, é +553587654321
A Gupshup usa o ID de WhatsApp (wa_id) +553587654321 para enviar a mensagem ao usuário, mas o negócio não está ciente do fato de que a mensagem foi enviada ao número sem o prefixo 9.
O evento de entrega tem um ID de mensagem destinado a ajudar o negócio a saber se a mensagem foi entregue.
Quando o usuário responde à mensagem, a Gupshup envia a mensagem com o número de telefone +553587654321 (idêntico ao ID de WhatsApo)
Dado que o negócio não sabe que este é o mesmo usuário +5535987654321, ele cria uma nova conversa C2 com +553587654321.

Conversa iniciada pelo usuário

Agora, digamos que o usuário comece a conversa. A Gupshup envia a mensagem dele com o número de telefone igual ao ID de WhatsApp. Com isso, o negócio pode fazer o opt-in com aquele número e continuar a conversa com o usuário.

Solução:

Enviamos um evento de discrepância (mismatch) sempre que o wa_id for diferente do número de telefone mencionado na solicitação de API. Confira abaixo o payload para um caso desses:

{
    "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"
        }
    }
}

Esse evento ajuda o seu negócio a gerenciar as conversas mais eficiente, e será recebido no webhook do seu negócio sempre que o número de destino na solicitação da API não for equivalente ao ID do WhatsApp — que é o número de telefone real registrado no WhatsApp.

A Gupshup também adicionará proativamente o ID de WhatsApp (número de telefone sem prefixo) à lista de opt-ins do seu negócio.

Confira o diagrama sequencial para entender melhor:

O que é um ID de WhatsApp?