QR Code do WhatsApp: abra a conversa com a mensagem pronta
Um QR code do WhatsApp é um QR code de URL comum cujo destino é um link de conversa wa.me. Ao ler, o WhatsApp abre com o seu número e, opcionalmente, uma mensagem já escrita no campo de texto. O visitante ainda aperta enviar — nada é enviado sozinho.
O formato do link wa.me
O endereço é https://wa.me/<número>, com o telefone em formato internacional e sem pontuação. Acrescente ?text= seguido da mensagem codificada na URL para preencher o campo. Mantenha a mensagem curta: cada caractere alonga o link e deixa os módulos impressos mais densos.
Formate o telefone em E.164
E.164 significa código do país seguido do número do assinante, apenas dígitos, sem sinal de mais e sem zero à esquerda depois do código do país. Um celular brasileiro escrito como (11) 91234-5678 vira 5511912345678. Um número dos EUA escrito como (555) 123-4567 vira 15551234567.
- Remova +, espaços, hífens e parênteses — o wa.me aceita apenas dígitos.
- Mantenha o código do país mesmo quando o público é local; uma leitura feita de um celular estrangeiro precisa funcionar.
- Teste com um número que realmente receba mensagens no WhatsApp, não com um telefone fixo.
Preencha a mensagem com codificação de URL
O parâmetro text precisa ser codificado em percentual. Um espaço vira %20, um apóstrofo %27, uma vírgula %2C e uma quebra de linha %0A. Espaços não codificados às vezes sobrevivem no navegador, mas falham em alguns leitores; codifique todo caractere reservado e confira a string final em uma aba comum do navegador antes de mandar para a gráfica.
Onde a conversa cai
Em um celular com WhatsApp instalado, o link abre o app; no desktop, oferece o WhatsApp Web. Um número sem conta no WhatsApp mostra erro, e uma conta comercial se comporta como qualquer outra conversa. Se você precisa encaminhar para uma caixa de equipe ou uma API, isso é outro produto — um código wa.me sempre cai em uma única conversa.
Perguntas frequentes
O visitante precisa salvar meu número antes?
Não. O wa.me abre a conversa direto; o número só é salvo se a pessoa escolher adicionar o contato.
A mensagem pode ser enviada automaticamente?
Não. Ela fica preenchida e o visitante aperta enviar. Envio silencioso exigiria a API do WhatsApp Business e consentimento explícito.
Por que meu código abre uma conversa vazia?
Confira o número: zero à esquerda, falta de código do país ou pontuação costumam levar o link a um número que não existe no WhatsApp.