Cómo crear un código QR vCard que guarda los contactos con un solo toque

Cualquiera puede leer un nombre en una tarjeta de visita. Casi nadie lo teclea. Un código QR vCard se salta el tecleo: un escaneo en el móvil, un toque en el aviso, y tu nombre, número, correo y cargo aterrizan directamente en los contactos de la otra persona.

Esta guía repasa las cuatro decisiones que en realidad determinan si tu QR se escanea limpiamente o se queda parpadeando ante el usuario: qué versión de vCard codificar, qué campos incluir, cómo componer la imagen del QR y cómo probarlo antes de encargar 500 tarjetas.

Qué es realmente un código QR vCard

Una vCard es un registro de contacto en texto plano definido por la RFC 6350 — el mismo formato text/vcard que los correos adjuntan como archivo .vcf. Mete ese texto dentro de un código QR y los escáneres modernos lo analizan y muestran un aviso «Añadir a Contactos» en lugar de volcar caracteres en bruto en la pantalla.

Esa es la única diferencia real entre un QR vCard y un QR de número de teléfono (el esquema tel:). Un QR de teléfono enseña los dígitos y le pide al usuario que marque o copie. Un QR vCard rellena nombre, organización, cargo, varios teléfonos y un correo con un solo toque. iOS Camera y Google Lens manejan el formato de forma nativa.

Elige una versión de vCard que los escáneres soporten de verdad

Existen tres revisiones vivas: 2.1 (1996), 3.0 (RFC 2426, 1998) y 4.0 (RFC 6350, 2011). La especificación actual es la 4.0. La versión que deberías codificar en la práctica es la 3.0.

¿Por qué? vCard 3.0 tiene el soporte más amplio entre los dispositivos instalados — iOS Camera, Google Lens, Outlook, Contactos de macOS, todos los escáneres OEM de Android importantes. La 4.0 añadió campos útiles (KIND, GENDER, MEMBER), pero la interoperabilidad todavía va por detrás de la 3.0 en algunos escáneres, sobre todo en versiones antiguas de Android que no puedes dar por actualizadas. A menos que necesites específicamente un campo exclusivo de la 4.0, la 3.0 es la opción más segura.

Qué va dentro de una vCard — y qué dejar fuera

Cuatro líneas son obligatorias: BEGIN:VCARD, VERSION:3.0, FN (nombre formateado) y END:VCARD. Todo lo demás es opcional.

Para un QR en una tarjeta de visita, los campos que realmente quieres son N (nombre estructurado en el orden Apellido;Nombre;Adicional;Prefijo;Sufijo), TEL, EMAIL, ORG, TITLE y URL. Seis propiedades. No añadas PHOTO — incrustar una imagen en base64 multiplica el tamaño del contenido y obliga al QR a un símbolo mucho mayor que no cabrá en la tarjeta. Sáltate los bloques largos de NOTE por el mismo motivo. ¿Necesitas un segundo número? Etiqueta el tipo: TEL;TYPE=cell:+1... y TEL;TYPE=work:+1....

Construye el contenido de la vCard

Aquí tienes una vCard completa y funcional para «Jamie Rivera, ingeniero de campo en Northwind»:

BEGIN:VCARD
VERSION:3.0
N:Rivera;Jamie;;;
FN:Jamie Rivera
ORG:Northwind
TITLE:Field Engineer
TEL;TYPE=cell:+15035551212
EMAIL:jamie@northwind.example
URL:https://northwind.example/jamie
END:VCARD

Cada línea termina con CRLF (\r\n). Dentro de un valor, escapa las comas con \,, los puntos y comas con \;, las barras invertidas con \\ y los saltos de línea con \n. Pega el bloque en cualquier generador de QR (o en el creador de QRDock), previsualiza el resultado y vuelve a copiar el contenido una vez para comprobar que entra y sale limpiamente antes de generar la imagen.

Genera la imagen del QR

Tres ajustes importan.

Corrección de errores: elige Q (25 % de redundancia) para cualquier cosa impresa. Sobrevive a la tinta corrida, los bordes recortados y el desgaste leve. Usa L (7 %) solo cuando el contenido empuje el símbolo a un tamaño que no cabe. H (30 %) es excesivo para una tarjeta, aunque resulta útil cuando quieres meter un pequeño logotipo en el centro.

Tamaño del módulo: a la distancia de lectura habitual (unos 30 cm para una tarjeta de visita), apunta a al menos 3 módulos por milímetro — eso deja un símbolo vCard de 25×25 en aproximadamente 1,5 cm de ancho.

Zona de silencio y contraste: deja al menos cuatro módulos de borde blanco a cada lado y mantén un contraste superior a 4:1 (oscuro sobre claro, nunca claro sobre oscuro). Los QR invertidos se escanean en algunos Android y fallan en la mayoría de iPhones.

Pruébalo en iOS y Android antes de imprimir

Genera la imagen y luego pruébala al tamaño más pequeño al que vayas a imprimirla, bajo la peor iluminación que prevés.

En iPhone: abre Cámara, apunta al QR, espera el banner de contacto en la parte superior de la pantalla. En Android: abre Google Lens o la app de cámara predeterminada (el comportamiento varía según el fabricante). Ambos deberían mostrar un aviso «Añadir a Contactos» en menos de un segundo.

Si el aviso no aparece, los sospechosos habituales son una línea VERSION que falta, finales de línea LF en lugar de CRLF, un contenido demasiado grande que supera la capacidad del nivel de corrección elegido o un campo PHOTO que olvidaste eliminar.

Dónde colocar tu QR vCard

Tarjetas de visita: esquina inferior derecha, de 1 a 1,5 cm de ancho, impreso en la misma tinta que el resto del diseño. Firmas de correo: un PNG de 80–120 px con el texto alternativo «Añádeme a tus contactos». Acreditaciones de eventos: 2–3 cm de ancho, centrado, con tu nombre impreso al lado por si el primer escaneo falla.

Si vas a entregar el QR a invitados de un evento, combina bien con un código QR de Wi-Fi — se conectan a la red del local y guardan tu contacto en dos escaneos.

Preguntas frecuentes

¿Cuál es la diferencia entre un QR vCard y un QR de contacto normal?

Un QR vCard lleva un contenido text/vcard que los móviles reconocen como una ficha de contacto. Un QR de texto plano o de número de teléfono solo muestra la cadena en bruto y le pide al usuario que la copie. Con vCard, iOS Camera y Google Lens en Android muestran un aviso «Añadir a Contactos» en el primer escaneo.

¿El destinatario necesita una app especial para escanear un QR vCard?

No. La app Cámara incorporada en iPhone (iOS 11 en adelante) y Google Lens en Android reconocen los contenidos vCard de forma nativa. Cualquier escáner QR moderno que siga el estándar QR Code mostrará la ficha de contacto.

¿Cómo de grande puede ser un QR vCard antes de dejar de escanearse?

Los símbolos QR llegan hasta unos 4.200 caracteres alfanuméricos en el nivel de corrección de errores más bajo, pero la legibilidad cae rápido por encima de los 300 caracteres cuando se imprime pequeño. Sáltate la foto incrustada (PHOTO en base64) y las notas largas si el QR tiene que caber en una tarjeta de visita.

¿Debo usar vCard 3.0 o vCard 4.0?

Usa vCard 3.0 a menos que tengas una razón concreta para la 4.0. La versión 3.0 tiene la interoperabilidad más amplia en iOS, Android, Outlook y Contactos de macOS. La 4.0 es el estándar IETF actual, pero el soporte aún va por detrás en algunos escáneres.

¿Puedo actualizar un QR vCard después de imprimirlo?

No directamente — un QR vCard estático codifica el texto del contacto dentro de la propia imagen, así que la única forma de cambiarlo es reimprimirlo. Si necesitas actualizaciones, codifica una URL corta que apunte a un archivo .vcf alojado en tu servidor y actualiza el archivo detrás de la URL.

Para terminar

Un QR vCard es una de las cosas con menos esfuerzo y mayor rentabilidad que puedes hacer con el formato: construyes el texto una vez, eliges vCard 3.0, generas con corrección de errores Q, lo pruebas en un iPhone y un Android reales al tamaño de impresión y entonces sí lanzas la tirada.

Si vas a repartir códigos QR entre desconocidos — en un congreso, en un envase, en un folleto — ayuda saber cómo comprobar si un código QR es seguro de escanear antes de tocar el aviso. Puedes crear tu QR vCard gratis en qrdock.app, que además ejecuta una comprobación de seguridad sobre los QR que escaneas con la app.