CodeBox Hub
GRÁTIS

QR Code para E-mail: Campos mailto: e Armadilhas de Codificação URL

Codifique endereço, assunto e corpo de e-mail com o esquema mailto:. Tabela de campos, armadilhas de codificação URL e tutorial em 3 etapas.

# 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

CampoSintaxeObrigatórioExemploNotas
Esquemamailto:Simmailto:Minúsculas, sempre
Endereçoaddress@hostSimhi@codeboxhub.comApenas um endereço no slot principal
CC?cc=Não?cc=team@x.comMúltiplos valores separados por vírgula
BCC&bcc=Não&bcc=b@x.comOculto dos destinatários
Assunto&subject=Não&subject=Hi%20thereEspaços como %20
Corpo&body=Não&body=Line%0A2Quebras de linha como %0A

Armadilhas de Codificação URL

Caractere brutoCodificadoO que acontece se você pular
Espaço%20A URI quebra; a maioria dos clientes abre um rascunho em branco
Ampersand%26Inicia um novo parâmetro; o assunto é truncado
Ponto de interrogação%3FInicia a string de consulta no meio do texto
Hash%23Inicia um fragmento; o corpo pode ser cortado
Mais%2BInterpretado como espaço em strings de consulta
Quebra de linha%0AQuebras de linha brutas são inválidas no payload
CJK ou emojiPercentual UTF-8Renderiza como mojibake no Gmail e Outlook
Sinal de percentual%25Um % literal no corpo é lido como o início de uma sequência
Vírgula%2CAlguns 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

  1. Insira o destinatário, assunto e corpo no gerador de QR de e-mail.
  2. Inspecione a pré-visualização da string mailto: codificada em percentual, depois exporte PNG ou SVG.
  3. 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

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.

FAQ

O que um QR code para e-mail faz?

Ele abre o aplicativo de e-mail padrão com o destinatário pré-preenchido, e o assunto e corpo se você os incluiu. Ele nunca envia o e-mail.

Um QR code pode abrir o Gmail diretamente?

Não. O esquema mailto: abre o app de e-mail que o telefone trata como padrão; ele não pode forçar o Gmail especificamente.

Quais caracteres devem ser codificados em URL em um link mailto:?

Espaços, ampersands, pontos de interrogação, hashes, sinais de mais e qualquer texto não-ASCII. Codifique-os como %20, %26, %3F, %23, %2B e sequências percentuais UTF-8.

Um QR code de e-mail pode anexar um arquivo?

Não. O esquema mailto: não tem um mecanismo de anexo confiável, então o rascunho sempre abre sem anexos.

QR codes de e-mail funcionam em iPhone e Android?

Sim. Ambos os sistemas tratam mailto: como uma URI de sistema e abrem o app de e-mail padrão sem instalar nada.

Como um QR mailto: difere de um QR code de contato?

Um código mailto: inicia um único rascunho de e-mail, enquanto um código de contato vCard adiciona a pessoa inteira — nome, números, empresa — ao livro de endereços.

Posso colocar um endereço de resposta em um QR code mailto:?

Não de forma confiável. A maioria dos clientes ignora reply-to dentro de URIs mailto:, então mantenha o caminho de resposta apenas no endereço principal.

Continue lendo

Fale conosco