Sumário
Resposta curta: Um link de click-to-chat é
https://wa.me/seguido do número de telefone em formato internacional, usando apenas dígitos, sem sinal de mais, espaços ou zero à esquerda. Adicione?text=e uma mensagem codificada em percent-encoding para preencher a primeira mensagem.
O recurso "Click-to-Chat" do WhatsApp permite que os usuários iniciem uma conversa com alguém sem precisar ter o número de telefone salvo na agenda. Desde que você conheça o número de telefone de uma pessoa ou empresa e ela tenha uma conta ativa no WhatsApp, você pode criar um link direto que abre uma janela de conversa imediatamente.
Parece simples, mas pequenos erros de formatação quebram o link: sinal de mais (+), zero à esquerda (0), parênteses ou codificação incorreta de quebras de linha.
Este guia cobre os formatos exatos de URL, as regras de números e os detalhes de codificação que mantêm os links do WhatsApp funcionando no desktop, iOS e Android.
1. Os Formatos Oficiais de URL do WhatsApp
O WhatsApp oferece suporte oficial a dois formatos de URL para iniciar conversas diretas:
O Padrão Moderno: https://wa.me/<número>
O padrão moderno recomendado é o wa.me, um domínio curto pertencente ao WhatsApp/Meta:
https://wa.me/14155552671
Com texto pré-preenchido:
https://wa.me/14155552671?text=Hello%20I%20have%20a%20question
O Endpoint Legado: https://api.whatsapp.com/send
Um endpoint mais antigo que permanece totalmente compatível:
https://api.whatsapp.com/send?phone=14155552671&text=Hello%20World
Recomendação: Use sempre https://wa.me/ para sites modernos, bios de redes sociais e campanhas de marketing. É mais curto e é o formato que as próprias páginas de ajuda do WhatsApp usam.
2. Formatação do Número: O Padrão E.164
O motivo mais comum para links click-to-chat falharem com o erro "The phone number shared via url is invalid" é a formatação incorreta do número.
Regras Estritas de Formatação:
- Omita qualquer
+inicial: Escreva14155552671, NÃO+14155552671. - Omita códigos de saída nacional ou prefixos de tronco: Por exemplo, números do Reino Unido começam com
07...localmente. No formato internacional, remova o0inicial e coloque o código do país44:447123456789, NÃO4407123456789. - Omita todos os hífens, espaços e colchetes: Remova completamente
-,(,)e espaços.
| País | Formato de exibição local | Formato correto no wa.me |
Tentativa incorreta comum |
|---|---|---|---|
| Estados Unidos | (415) 555-2671 | 14155552671 |
+1 (415) 555-2671 |
| Reino Unido | 07911 123456 | 447911123456 |
4407911123456 |
| Alemanha | 0151 12345678 | 4915112345678 |
+49 151 12345678 |
| Brasil | (11) 98765-4321 | 5511987654321 |
+55 (11) 98765-4321 |
| Índia | 98765 43210 | 919876543210 |
+91 98765-43210 |
Para verificar e validar números de telefone antes de lançar campanhas, use nosso Validador de Números do WhatsApp gratuito.
3. Codificando Mensagens Pré-Preenchidas (Quebras de Linha, Emojis e Markdown)
Uma mensagem pré-preenchida poupa o cliente de ter que decidir o que digitar.
Como os parâmetros de consulta em URLs devem seguir o RFC 3986, caracteres especiais precisam ser codificados em percent-encoding:
- Espaço:
%20(ou+) - Quebra de linha (
\n):%0A - Ponto de interrogação (
?):%3F - E comercial (
&):%26
Exemplo: Consulta de Pedido em Várias Linhas com Emojis
Suponha que você queira que a mensagem pré-preenchida seja:
👋 Hi! I want to order:
- Item: Silk Shirt (Size M)
- Shipping: Express
URL codificada:
https://wa.me/14155552671?text=%F0%9F%91%8B%20Hi!%20I%20want%20to%20order%3A%0A-%20Item%3A%20Silk%20Shirt%20(Size%20M)%0A-%20Shipping%3A%20Express
Para compor, formatar e visualizar facilmente mensagens estilizadas com negrito (*texto*), itálico (_texto_) e tachado (~texto~), confira nosso Formatador de Mensagens do WhatsApp.
4. Gerando QR Codes para Materiais Físicos e Embalagens
Links de click-to-chat não moram apenas em sites. Quando impressos como QR codes em:
- Embalagens de produtos e manuais de instrução
- Enfeites de mesa e cardápios de restaurantes
- Panfletos impressos, estandes de feiras e recibos
...eles permitem que os clientes escaneiem com a câmera e caiam direto na sua fila de atendimento do WhatsApp.
Você pode gerar QR codes SVG e PNG de alta definição prontos para impressão com o logotipo da sua marca usando nosso Gerador de QR Code de Contato do WhatsApp.
5. Resumo e Lista de Verificação de Boas Práticas
Antes de colocar qualquer link de click-to-chat em produção:
- O número contém apenas dígitos numéricos (sem
+, hífens ou espaços). - O prefixo de tronco nacional (
0) foi removido. - O parâmetro de texto está corretamente codificado em URL (especialmente
%0Apara quebras de linha). - Testado no iOS (Safari) e Android (Chrome).
- Campanha rastreada com tags UTM ou rastreamento de link se estiver usando anúncios pagos.
Para criar links automaticamente com uma prévia interativa ao vivo, use o Gerador de Links do WhatsApp da WAButton gratuito.
Fontes
- Como usar o click to chat, Central de Ajuda do WhatsApp
- RFC 3986: URI Generic Syntax, IETF
- E.164: The international public telecommunication numbering plan, ITU
Deixe os visitantes do seu site enviarem mensagens para você no WhatsApp.
Adicione um botão flutuante, escolha as cores e a saudação e responda no aplicativo do WhatsApp que você já usa.
WAButton é um botão para site. Não vendemos acesso à API do WhatsApp nem uma caixa de entrada compartilhada, então nada aqui depende de você comprar isso.
Escrito por Equipe de WAButton