Pular para o conteúdo
apiwpp
Termo

Nono dígito no WhatsApp

O nono dígito é o 9 que os celulares brasileiros ganharam na frente do número. Contas de WhatsApp antigas podem continuar registradas sem ele, e uma mensagem enviada ao endereço com o 9 não chega até elas.

Atualizado em

O nono dígito é o 9 que os celulares brasileiros passaram a ter na frente do número, de forma gradual por região, na década de 2010. (11) 8888-7777 virou (11) 98888-7777. Para as ligações a mudança foi resolvida pelas operadoras, mas no WhatsApp ela deixou um efeito que aparece até hoje em qualquer integração.

Contas antigas registradas sem o 9

Quem criou a conta de WhatsApp antes da mudança pode continuar registrado com o número antigo, sem o 9. O endereço interno dessa conta, o JID, é algo como [email protected]. Contas mais novas estão registradas com o 9: [email protected].

Para a pessoa, não faz diferença: ela informa o celular com o 9, como em qualquer cadastro. A diferença só aparece quando um sistema tenta falar com ela pelo WhatsApp.

Por que montar o endereço na mão falha

Muitas integrações pegam o telefone do cadastro, limpam os símbolos e acrescentam @s.whatsapp.net. Com uma conta registrada sem o 9, esse endereço não corresponde à conta, e a mensagem não chega a quem deveria.

A correção "óbvia" também falha: tirar o 9 de todos os números quebra o envio para as contas registradas com ele. E não existe regra fixa por DDD ou por idade do número que diga qual formato cada conta usa. A única fonte confiável é o próprio WhatsApp.

Como a apiwpp resolve

Na apiwpp, o campo to do envio recebe o número só com dígitos, com código do país e DDD, do jeito que está no seu cadastro:

{ "to": "5511988887777", "message": "Olá! Sua consulta está confirmada." }

Antes de enviar, a apiwpp pergunta ao WhatsApp em qual JID aquele número está registrado e envia para esse endereço. Assim, contas antigas registradas sem o nono dígito recebem a mensagem mesmo quando você manda o número com ele. A apiwpp nunca inclui nem remove o nono dígito por conta própria: ela usa o que o WhatsApp responde. Um número que não está no WhatsApp falha na hora, com not_on_whatsapp.

Para conferir uma lista antes de enviar, use a verificação de números: até 100 telefones por chamada, com o jid em que cada um está registrado, com ou sem o 9.

Nos webhooks, o campo phone traz o telefone como o WhatsApp o conhece. Se o seu cadastro guarda o número com o 9 e a conta é antiga, phone pode vir sem ele; compare os dois formatos ao procurar o contato. O passo a passo completo está no artigo o nono dígito no WhatsApp.

Perguntas frequentes

Devo cadastrar o número com ou sem o nono dígito?

Cadastre como o cliente informar, normalmente com o 9, e envie assim no campo to. A apiwpp consulta o WhatsApp e acerta o endereço a cada envio.

Por que o telefone que chegou no webhook está sem o 9?

Porque aquela conta foi registrada no WhatsApp sem o nono dígito. A apiwpp não altera o número: o campo phone é o telefone como o WhatsApp o conhece.

Isso vale para números fixos?

O nono dígito é dos celulares. Números fixos com WhatsApp Business seguem com oito dígitos depois do DDD, e a apiwpp também consulta o WhatsApp antes de enviar para eles.

JID (Jabber ID) é o endereço interno que o WhatsApp usa para cada conversa: um contato é algo como [email protected], um grupo termina em @g.us e um contato identificado sem telefone termina em @lid.

LID (linked identity) é um identificador do WhatsApp, como 11122233344455@lid, que representa um contato sem revelar o número de telefone. É estável para o contato, mas não tem relação com o telefone.

Template de mensagem é um texto salvo com variáveis, como {{nome}} e {{pedido}}, que o sistema reutiliza em cada envio preenchendo os valores. Na Cloud API da Meta, o template precisa de aprovação; na apiwpp, é uma mensagem salva, sem aprovação.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.