O formato de link do WhatsApp, explicado
Tudo sobre os links «click-to-chat» do WhatsApp em um só lugar: os formatos de URL exatos, os parâmetros de número e texto, como escrever o número, como codificar a mensagem e os erros que quebram um link sem você perceber. Salve, cite, construa a partir dele.
O que é um link click-to-chat
Um link click-to-chat do WhatsApp (muitas vezes chamado de «link wa.me») é uma URL comum que abre uma conversa do WhatsApp com uma mensagem já digitada. A pessoa toca no link, o WhatsApp abre e ela só precisa tocar em enviar. Sem salvar um número, sem copiar texto entre aplicativos.
O link carrega no máximo duas informações: com qual número abrir a conversa e qual mensagem preencher. Ambas são opcionais, e é isso que torna o formato flexível: você pode apontar para um contato específico ou compartilhar uma mensagem pronta que qualquer pessoa pode encaminhar para quem quiser.
A mensagem é apenas preenchida, nunca enviada automaticamente. Quem recebe sempre toca em enviar, então um link click-to-chat não pode mandar mensagem a ninguém em seu nome.
Os três formatos de URL
O WhatsApp aceita três URLs intercambiáveis para o click-to-chat. Elas se comportam da mesma forma; o wa.me é simplesmente a curta e oficial.
wa.me: o link curto
O domínio curto oficial do WhatsApp. O número vai direto no caminho; a mensagem é um ?text= opcional. É a forma a preferir em todo lugar.
https://wa.me/<número>?text=<mensagem codificada>api.whatsapp.com/send: o link longo
O equivalente antigo e mais longo. O número é um parâmetro phone em vez de um segmento de caminho. Comportamento idêntico; útil quando uma plataforma reescreve ou bloqueia o wa.me.
https://api.whatsapp.com/send?phone=<número>&text=<mensagem codificada>web.whatsapp.com/send: para computador
Aponta especificamente para o WhatsApp Web. Útil para links que você sabe que serão abertos em um computador; no celular ele mesmo repassa para o aplicativo.
https://web.whatsapp.com/send?phone=<número>&text=<mensagem codificada>Os parâmetros
Há apenas duas coisas que você pode definir: o número e o texto. Todo o resto da URL é fixo.
| Parâmetro | Obrigatório | Onde fica | O que faz |
|---|---|---|---|
número | Opcional | Segmento de caminho no wa.me; o parâmetro phone no api/web.whatsapp.com | O contato com quem abrir a conversa, em formato internacional completo, somente dígitos. Omita para deixar a pessoa escolher para quem enviar a mensagem. |
text | Opcional | Parâmetro de consulta ?text= | A mensagem a preencher na caixa de conversa, codificada em URL. Omita para abrir a conversa com a caixa vazia. |
Como escrever o número de telefone
O motivo mais comum de um link abrir uma conversa vazia ou errada é um número mal formatado. As regras são rígidas, mas simples:
- Comece pelo código do país (por exemplo 55 para o Brasil, 351 para Portugal, 1 para EUA/Canadá).
- Use somente dígitos: sem sinal de mais, sem espaços, sem traços, sem parênteses.
- Não use um 0 inicial. Os zeros nacionais são descartados quando o código do país é adicionado.
- Também não coloque 00 na frente: o código do país sozinho já basta.
+44 (0)7911 123 456447911123456Como codificar a mensagem
O parâmetro text precisa ser codificado em URL para que espaços e símbolos sobrevivam à barra de endereços. Se você monta links à mão, estes são os caracteres que atrapalham:
| Caractere | Codificado como |
|---|---|
| espaço | %20 (ou +) |
| quebra de linha | %0A |
| & (e comercial) | %26 |
| # (cerquilha) | %23 |
| ? (interrogação) | %3F |
| % (porcentagem) | %25 |
| + (mais) | %2B |
Emojis funcionam sem nada de especial. Se tudo isso parecer trabalhoso, não codifique à mão: o gerador abaixo faz isso por você e mostra o link pronto.
O que acontece quando alguém toca
No celular, o link abre o aplicativo do WhatsApp diretamente, na conversa escolhida, com a mensagem já preenchida. Mesmo que o número não esteja salvo como contato, o WhatsApp abre a conversa assim mesmo. É justamente essa a ideia.
No computador, abre o WhatsApp Web ou o aplicativo para desktop quando a pessoa está conectada ali; caso contrário, mostra uma página convidando a abrir o WhatsApp. Vale testar nos dois se o seu público é variado.
Se você omitir o número, o WhatsApp abre e deixa a pessoa escolher para quem enviar a mensagem: até várias conversas de uma vez. Isso torna um link sem número ideal para uma mensagem que você quer espalhar, em vez de uma conversa com você.
Uma observação sobre links de grupo (eles são diferentes)
Um convite de grupo não é um link click-to-chat e não usa o wa.me. Ele tem a forma https://chat.whatsapp.com/<código> e é gerado dentro do WhatsApp pela opção «Convidar por link» do grupo. Você não consegue criá-lo a partir de um número, e o parâmetro text não tem efeito sobre ele.
Exemplos para copiar e colar
Links que funcionam e você pode adaptar: troque pelo seu número e mensagem.
https://wa.me/447911123456https://wa.me/447911123456?text=Hi%2C%20I%27d%20like%20more%20infohttps://wa.me/?text=Check%20this%20out%3A%20https%3A%2F%2Fexample.comhttps://api.whatsapp.com/send?phone=447911123456&text=HelloErros comuns
- Deixar o + , os espaços ou os traços no númeroTire tudo menos os dígitos: +44 7911 123456 → 447911123456.
- Manter o zero inicial localRemova-o quando o código do país já está lá: 07911… → 447911…
- Não codificar a mensagem em URLCodifique espaços e símbolos (espaço → %20, & → %26), ou deixe um gerador fazer isso.
- Esperar que a mensagem se envie sozinhaEla é apenas preenchida; quem recebe toca em enviar. É assim de propósito.
- Usar o wa.me para um grupoConvites de grupo usam chat.whatsapp.com/<código>, criado dentro do WhatsApp.
Não monte isso à mão
Agora você sabe exatamente como o formato funciona, mas raramente precisa montá-lo sozinho. Nossas ferramentas gratuitas cuidam da formatação do número e da codificação da mensagem, e te dão um link para copiar ou transformar em código QR em segundos.