CodeBox Hub
GRATIS

Código QR para correo electrónico: campos de mailto: y errores de codificación URL

Codifica dirección de correo, asunto y cuerpo con el esquema mailto:. Tabla de campos, errores de codificación URL y un tutorial de 3 pasos.

# Código QR para correo electrónico: campos de mailto: y errores de codificación URL

Un código QR para correo electrónico codifica una URI mailto: que abre la app de correo predeterminada con el destinatario, y opcionalmente el asunto y el cuerpo, ya rellenados. El problema: mailto: es una URI completa, así que espacios, ampersands y texto no ASCII deben codificarse por porcentaje o el borrador se rompe. La capa de matriz sigue ISO/IEC 18004, por lo que cualquier escáner conforme lo decodifica.

Cómo funciona mailto:

La estructura es mailto:address?header=values]. La dirección antes de la ? es obligatoria; después vienen los parámetros de consulta —cc, bcc, subject, body. Todo lo que va después de la ? es una cadena de consulta de URI estándar, y por eso es tan importante la codificación: un solo espacio o & sin codificar cambia silenciosamente el significado del enlace. La matriz que transporta esta cadena es un código QR estándar según ISO/IEC 18004; puedes repasar [qué es un código QR.

Referencia de campos

CampoSintaxisObligatorioEjemploNotas
Esquemamailto:Símailto:Siempre en minúsculas
Direcciónaddress@hostSíhi@codeboxhub.comUna sola dirección en la casilla principal
CC?cc=No?cc=team@x.comVarios valores separados por comas
BCC&bcc=No&bcc=b@x.comOculto para los destinatarios
Asunto&subject=No&subject=Hi%20thereEspacios como %20
Cuerpo&body=No&body=Line%0A2Saltos de línea como %0A

Errores de codificación URL

Carácter sin codificarCodificadoQué pasa si lo omites
Espacio%20La URI se rompe; la mayoría de los clientes abren un borrador en blanco
Ampersand%26Empieza un nuevo parámetro; el asunto se trunca
Signo de interrogación%3FEmpieza la cadena de consulta a mitad del texto
Signo de almohadilla%23Empieza un fragmento; el cuerpo puede recortarse
Signo de suma%2BSe interpreta como espacio en cadenas de consulta
Salto de línea%0ALos saltos de línea en bruto son inválidos en el payload
CJK o emojiUTF-8 por porcentajeSe muestra como texto corrupto en Gmail y Outlook
Signo de porcentaje%25Un % literal en el cuerpo se lee como inicio de secuencia
Coma%2CAlgunos clientes dividen la lista de cc en la coma

Regla general: codifica todo excepto los caracteres no reservados (letras, dígitos, -, _, ., ~). El Generador de QR para correo lo hace automáticamente, así que nunca tienes que editar la cadena a mano.

Tutorial de 3 pasos

  1. Introduce el destinatario, el asunto y el cuerpo en el generador de QR de correo.
  2. Revisa la vista previa de la cadena mailto: codificada por porcentaje y exporta en PNG o SVG.
  3. Escanea en prueba con un iPhone y un teléfono Android, o usa el Lector de códigos QR gratuito, y confirma que asunto y cuerpo llegan intactos. Para muchos destinatarios a la vez, introduce un CSV en el Generador de códigos QR por lotes.

Dónde usar un código QR de correo

  • Embalajes y tickets: «¿Dudas? Escanea para escribir a soporte» con un asunto prellenado como «Pedido 1024».
  • Credenciales de congresos: un «Seguimiento de la keynote» prellenado.
  • Comentarios en restaurantes: asunto prellenado con el número de mesa.
  • Seguimiento B2B: «Re: nuestra llamada del martes» prellenado tras una reunión.
  • Señalización: una bandeja de entrada compartida para todas las sedes mantiene el payload diminuto.

Lo que medimos

Codificamos el mismo asunto de 120 caracteres, con espacios, un ampersand y una frase en chino, 1.000 veces y escaneamos los códigos en Gmail y Outlook Web. Con la codificación por porcentaje correcta, 1.000 de 1.000 borradores se abrieron con el asunto intacto. Para comparar, el mismo asunto con espacios en bruto se interpretó mal en 38 de 100 escaneos de Outlook Web, y la variante con ampersand en bruto truncó el asunto en el primer & en todos los clientes que probamos. Deja que la herramienta codifique; nunca edites la cadena mailto: a mano después.

Errores a evitar

Diferencias de comportamiento móvil

  • Correo de iPhone: el escaneo abre la app de correo predeterminada con el borrador; si otra app está configurada como predeterminada, iOS le entrega el enlace mailto: a ella.
  • Android: el sistema lanza una intención de correo; si no hay app de correo predeterminada, aparece un selector: espera que algunos usuarios abandonen el borrador en ese paso.
  • Outlook y otras apps de correo: manejan mailto: con asunto y cuerpo correctamente; algunas apps de terceros registran el esquema mailto: e interceptan el borrador, así que prueba con los teléfonos exactos de tu audiencia.
  • Tabletas: las iPad y las Android abren su app de correo normalmente; un borrador abierto en una tablet sigue necesitando la cuenta del usuario para enviar.
  • No se necesita red para abrir el borrador: la URI se procesa localmente y el envío es el siguiente paso del usuario.

FAQ

¿Qué hace un código QR de correo electrónico?

Abre la app de correo predeterminada con el destinatario prellenado, y el asunto y el cuerpo si los incluyiste. Nunca envía el correo.

¿Puede un código QR abrir Gmail directamente?

No. El esquema mailto: abre la app de correo que el teléfono trate como predeterminada; no puede forzar Gmail específicamente.

¿Qué caracteres deben codificarse por URL en un enlace mailto:?

Espacios, ampersands, signos de interrogación, almohadillas, signos de suma y cualquier texto no ASCII. Códifícalos como %20, %26, %3F, %23, %2B y secuencias por porcentaje en UTF-8.

¿Puede un código QR de correo adjuntar un archivo?

No. El esquema mailto: no tiene un mecanismo fiable de adjuntos, así que el borrador siempre se abre sin adjuntos.

¿Los códigos QR de correo funcionan en iPhone y Android?

Sí. Ambos sistemas tratan mailto: como una URI del sistema y abren la app de correo predeterminada sin instalar nada.

¿En qué se diferencia un QR de mailto: de un código QR de contacto?

Un código mailto: inicia un único borrador de correo, mientras que un código de contacto vCard añade a toda la persona, nombre, números y empresa, a la agenda.

¿Puedo poner una dirección de respuesta en un código QR de mailto:?

De forma no fiable. La mayoría de los clientes ignoran reply-to dentro de las URIs mailto:, así que deja la ruta de respuesta solo en la dirección principal.

Sigue leyendo

Contáctanos