O link do WhatsApp resolve um atrito bobo e caro: obrigar o cliente a copiar um número, abrir a agenda, salvar o contato e só então mandar mensagem. Com o endereço certo, um toque abre a conversa já com o texto digitado. A regra que faz isso funcionar é simples, mas quase todo link quebrado erra o mesmo detalhe. Este guia mostra o formato correto, os erros mais comuns e como colocar o botão no seu site. Para montar o seu com validação de DDD, use o gerador de link do WhatsApp.
Resposta rápida
- O formato é https://wa.me/5511999998888: código do país, DDD e número, tudo emendado.
- Só algarismos. Sem zero na frente do DDD, sem parêntese, sem hífen, sem espaço e sem o sinal de mais.
- Para a mensagem pronta, acrescente ?text= com o texto codificado para URL.
- Celular brasileiro tem 9 algarismos depois do DDD e começa com 9. Fixo em geral não tem WhatsApp.
O formato do link
O endereço tem duas partes. A primeira é o número em formato internacional, emendado: código do país, DDD e assinante. A segunda, opcional, é a mensagem que já aparece escrita no campo de digitação.
Um celular de São Paulo com DDD 11 e número 99999-8888 vira https://wa.me/5511999998888. Com mensagem, fica https://wa.me/5511999998888?text=Ol%C3%A1. Aquele %C3%A1 é a letra á convertida para o formato que uma URL aceita, e essa conversão não é opcional: acento, espaço, emoji e quebra de linha precisam ser codificados, senão o link chega truncado ou simplesmente não abre.
Ao clicar, o WhatsApp abre a conversa com aquele número. No celular, o aplicativo assume; no computador, abre o WhatsApp Web ou o programa instalado. A pessoa não precisa ter você na agenda, e você também não precisa ter ela.
Os erros que quebram o link
Praticamente todo link que não funciona erra o número, e quase sempre num destes pontos.
Deixar o zero na frente do DDD
Escrever 011 em vez de 11 é herança da discagem por operadora. No formato internacional esse zero não existe, e o link com ele aponta para um número que ninguém tem.
Esquecer o código do país
Sem o 55 na frente, o WhatsApp não sabe de qual país é o número e não abre a conversa. Vale para qualquer link, mesmo que quem clica esteja no Brasil.
Manter a máscara
Parêntese, hífen, ponto e espaço não podem aparecer. Colar (11) 99999-8888 direto na URL produz um endereço inválido.
Usar o sinal de mais
O + funciona ao discar, mas na URL ele é interpretado de outro jeito e atrapalha. O link leva apenas algarismos.
Repetir o código do país
Acontece quando alguém já tem o número salvo como 5511999998888 e acrescenta outro 55 na frente. O resultado, 555511999998888, não corresponde a nada.
Usar um DDD que não existe
O Brasil usa 67 códigos de área, e vários números na faixa de 10 a 99 nunca foram atribuídos: 20, 23, 25, 26, 29, 36, 39, 40, 50, 52, 56 a 60, 70, 72, 76, 78, 80 e 90. Um erro de digitação que caia num desses gera link que nunca abre, sem nenhuma mensagem de erro que explique o motivo. O gerador do ValorFinal confere isso e avisa na hora.
O nono dígito
Todo celular no Brasil tem 9 algarismos depois do DDD e começa com 9. Com o DDD são 11 algarismos, e com o código do país, 13. Telefone fixo tem 8 algarismos depois do DDD, totalizando 10 e 12.
Isso importa por dois motivos. Primeiro, muita agenda antiga ainda guarda celular com 8 algarismos, e esse número não funciona mais. Segundo, o WhatsApp em telefone fixo é possível apenas em conta Business com verificação por chamada, e é raro. Se o link aponta para um fixo, o mais provável é que ele não abra conversa nenhuma.
A mensagem pré-preenchida
O parâmetro ?text= preenche o campo de digitação, e a pessoa ainda pode editar ou apagar antes de enviar. Isso tem duas implicações práticas.
A boa é que uma mensagem pronta aumenta muito a chance de o contato acontecer, porque remove a hesitação de ter que escrever a primeira frase. Algo como "Olá! Vim pelo site e quero saber sobre o plano mensal" funciona melhor que um campo vazio. Também ajuda a identificar de onde veio o contato: se cada página do seu site usa um texto diferente, você sabe qual delas converteu, sem precisar de rastreamento nenhum.
A ruim é que o texto não é confiável. Como a pessoa pode trocar tudo antes de enviar, nunca use a mensagem pré-preenchida como confirmação de pedido, aceite de proposta ou qualquer coisa que dependa do conteúdo ter chegado intacto.
Como colocar o botão no site
O link é uma URL comum, então um botão é só um elemento de âncora apontando para ela. Dois cuidados fazem diferença: abrir em nova aba, para não tirar a pessoa do seu site, e usar rel="noopener noreferrer", que impede a página aberta de manipular a original. O trecho pronto que o gerador entrega já vem com os dois.
No WordPress, cole o trecho num bloco de HTML personalizado. Em construtores visuais, use o componente de botão e ponha a URL no campo de link. Se você quiser o botão flutuante no canto da tela, basta posicionar o mesmo elemento com position: fixed.
Para atendimento presencial, imprima o link como QR Code e deixe no balcão, na vitrine ou no cartão. Cole a URL no gerador de QR Code e baixe em SVG, que é o formato que não perde qualidade ao ampliar para um adesivo grande.
Cuidados de segurança
Se você monta o link por programação, com o número ou a mensagem vindo de um formulário, dois pontos merecem atenção. O texto precisa passar por codificação de URL antes de entrar no endereço, e precisa passar por escape de HTML antes de entrar num atributo da página. Sem isso, uma aspa na mensagem quebra o atributo e abre espaço para injetar conteúdo na sua página. O gerador do ValorFinal aplica as duas camadas no trecho que entrega.
Do outro lado, vale um alerta para quem recebe: link de WhatsApp é usado em golpe com frequência, geralmente com um número desconhecido se passando por empresa. Antes de clicar num link recebido, confira o número e desconfie de urgência. O mesmo cuidado vale para QR Code colado em local público, que pode ter sido trocado.
Como usar a ferramenta do ValorFinal
O gerador de link do WhatsApp remove a máscara, tira o zero de tronco, evita o código do país duplicado, confere o DDD contra a lista oficial da Anatel e exige o nono dígito. Ele entrega o link curto, o formato longo e o botão em HTML pronto para colar, e tudo é montado no seu navegador, sem enviar o número para servidor nenhum. Para medir o tamanho da mensagem antes de usar, veja o contador de caracteres. Para entender a codificação que transforma acento em %C3%A1, use o codificador de URL. Conheça as demais ferramentas de tecnologia.
Fontes oficiais
- WhatsApp: como usar o link de clique para conversar: documentação oficial do formato wa.me e do parâmetro de mensagem.
- Anatel: numeração e códigos de acesso: base oficial dos códigos de área em uso no Brasil.
- RFC 3986 (IETF): especificação de URI, que define como caracteres especiais são codificados numa URL.
Conclusão
O link do WhatsApp é wa.me seguido do número em formato internacional, só com algarismos, e nada mais. O que derruba a maioria dos links é sempre a mesma lista: zero na frente do DDD, código do país ausente ou repetido, máscara que ficou no meio e celular sem o nono dígito. A mensagem pronta no ?text= aumenta a taxa de contato e ainda serve para você saber de qual página veio a pessoa, desde que você não trate esse texto como algo confiável. Monte o seu no gerador de link do WhatsApp e confira as demais ferramentas de tecnologia.