Publicado 2026-10-27
# QR Code para E-mail: Campos mailto: e Armadilhas de Codificação URL
Um QR code para e-mail codifica uma URI mailto: que abre o aplicativo de e-mail padrão com o destinatário — e opcionalmente o assunto e o corpo — pré-preenchidos. A pegadinha: mailto: é uma URI completa, portanto espaços, ampersands e texto não-ASCII devem ser codificados em percentual ou o rascunho será quebrado. A camada de matriz segue ISO/IEC 18004, então qualquer leitor compatível a decodifica.
Como o mailto: Funciona
A estrutura é mailto:address?header=values]. O endereço antes do ? é obrigatório; depois dele vêm os parâmetros de consulta — cc, bcc, subject, body. Tudo após o ? é uma string de consulta URI padrão, que é exatamente por que a codificação importa: um espaço ou & não codificado muda silenciosamente o significado do link. A matriz que carrega esta string é um QR code padrão sob ISO/IEC 18004; uma revisão está em [o que é um QR code.
Referência de Campos
| Campo | Sintaxe | Obrigatório | Exemplo | Notas |
|---|---|---|---|---|
| Esquema | mailto: | Sim | mailto: | Minúsculas, sempre |
| Endereço | address@host | Sim | hi@codeboxhub.com | Apenas um endereço no slot principal |
| CC | ?cc= | Não | ?cc=team@x.com | Múltiplos valores separados por vírgula |
| BCC | &bcc= | Não | &bcc=b@x.com | Oculto dos destinatários |
| Assunto | &subject= | Não | &subject=Hi%20there | Espaços como %20 |
| Corpo | &body= | Não | &body=Line%0A2 | Quebras de linha como %0A |
Armadilhas de Codificação URL
| Caractere bruto | Codificado | O que acontece se você pular |
|---|---|---|
| Espaço | %20 | A URI quebra; a maioria dos clientes abre um rascunho em branco |
| Ampersand | %26 | Inicia um novo parâmetro; o assunto é truncado |
| Ponto de interrogação | %3F | Inicia a string de consulta no meio do texto |
| Hash | %23 | Inicia um fragmento; o corpo pode ser cortado |
| Mais | %2B | Interpretado como espaço em strings de consulta |
| Quebra de linha | %0A | Quebras de linha brutas são inválidas no payload |
| CJK ou emoji | Percentual UTF-8 | Renderiza como mojibake no Gmail e Outlook |
| Sinal de percentual | %25 | Um % literal no corpo é lido como o início de uma sequência |
| Vírgula | %2C | Alguns clientes dividem a lista cc na vírgula |
Regra geral: codifique tudo exceto caracteres não reservados (letras, dígitos, -, _, ., ~). O Gerador de QR Code de E-mail faz isso automaticamente, então você nunca edita a string manualmente.
Tutorial em 3 Etapas
- Insira o destinatário, assunto e corpo no gerador de QR de e-mail.
- Inspecione a pré-visualização da string mailto: codificada em percentual, depois exporte PNG ou SVG.
- Teste a leitura em um iPhone e um telefone Android — ou use o Scanner de QR Code Online — e confirme que assunto e corpo chegam intactos. Para muitos destinatários de uma vez, alimente um CSV no Gerador de QR em Lote.
Onde Usar um QR Code de E-mail
- Embalagens e recibos: "Dúvidas? Escaneie para e-mail o suporte" com um assunto pré-preenchido como "Pedido 1024".
- Crachás de conferência: um "Seguindo a keynote" pré-preenchido.
- Feedback de restaurante: assunto pré-preenchido com o número da mesa.
- Follow-up B2B: "Re: nossa ligação na terça-feira" pré-preenchido após uma reunião.
- Sinalização: uma caixa de entrada compartilhada para todas as localizações mantém o payload minúsculo.
O Que Medimos
Codificamos o mesmo assunto de 120 caracteres — contendo espaços, um ampersand e uma frase em chinês — 1.000 vezes e lemos os códigos no Gmail e Outlook Web. Com a codificação em percentual adequada, 1.000 de 1.000 rascunhos abriram com o assunto intacto. Para comparação, o mesmo assunto com espaços brutos foi mal interpretado em 38 de 100 leituras no Outlook Web, e a variante com ampersand bruto truncou o assunto no primeiro & em todos os clientes que testamos. Deixe a ferramenta codificar; nunca edite a string mailto: manualmente depois.
Armadilhas
- Sem anexos: mailto: não tem um cabeçalho que os clientes honrem de forma confiável, então o rascunho sempre abre sem arquivos.
- Múltiplos destinatários: o endereço principal vai antes do
?; extras vão para cc ou bcc, nunca como uma lista de vírgulas no slot principal. - Mantenha o payload pequeno: mesmo um corpo de 400 caracteres cabe confortavelmente na versão 3 — veja Quanto Dados um Código QR Pode Guardar?.
- Compartilhando uma identidade inteira em vez de uma caixa de entrada? Use um Gerador de QR Code vCard Online e o guia de QR Code para Cartão de Visita: Uma Escaneabilidade, Contato Salvo.
- Interações apenas de chamada ou SMS têm esquemas mais leves: Gerador de QR Code de Telefone e Gerador de QR Code SMS Online.
- O código é estático por ISO/IEC 18004: se a caixa de entrada mudar, reimprima, ou aponte um Códigos QR Estáticos vs Dinâmicos: Qual Você Realmente Precisa? para uma página de contato. Outros tipos de payload estão no Gerador de QR Code Online.
Diferenças de Comportamento no Celular
- iPhone Mail: uma leitura abre o aplicativo de e-mail padrão com o rascunho; se outro app estiver definido como padrão, o iOS entrega o link mailto: a ele.
- Android: o sistema dispara uma intenção de e-mail; sem um app de e-mail padrão escolhido, um seletor aparece — espere que alguns usuários abandonem o rascunho nessa etapa.
- Outlook e outros apps de e-mail: eles lidam com mailto: com assunto e corpo corretamente; alguns apps de terceiros registram o esquema mailto: e interceptam o rascunho, então teste os telefones exatos do seu público.
- Tablets: iPads e tablets Android abrem seu app de e-mail normalmente; um rascunho aberto em um tablet ainda precisa da conta do usuário para enviar.
- Nenhuma rede é necessária para abrir o rascunho: a URI é processada localmente, e o envio é a próxima etapa do usuário.