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.
Outros termos
Todos: Glossário →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.