El formato vCard, línea a línea

Un archivo vCard (.vcf) es texto plano, una propiedad por línea. Se usan tres versiones, y se diferencian sobre todo en cómo escriben los parámetros, los juegos de caracteres y las fotos.

Gratis, funciona en tu navegador, no se sube nada, sin cuenta.

Abrir el visor y conversor VCF
Una línea de teléfono en vCard 2.1, 3.0 y 4.0Un número de móvil, tres versiones2.1TEL;CELL;VOICE:+1 555 555 0142especificación de versit, 1996 · tipos sin nombre de parámetro3.0TEL;TYPE=CELL:+1 555 555 0142RFC 2426, 1998 · con TYPE=4.0TEL;TYPE=cell;VALUE=uri:tel:+1-555-555-0142RFC 6350, 2011 · solo UTF-8 · enlace tel:

vCard 2.1, 3.0 y 4.0 comparadas

2.13.04.0
EstándarEspecificación del consorcio versit (no es un RFC)RFC 2426RFC 6350
Publicación199619982011
Líneas obligatoriasVERSION; N en la prácticaVERSION, N, FNVERSION, FN
Así se escribe un móvilTEL;CELL:TEL;TYPE=CELL:TEL;TYPE=cell:
Juego de caracteresCHARSET= en cada línea, a menudo una página de códigos localno se indica en el archivo; UTF-8 en la prácticaUTF-8, siempre
Texto con tildespuede ir en quoted-printabletexto planotexto plano
FotosENCODING=BASE64ENCODING=b (base64)un URI, a menudo un URI data:
Quién la escribeteléfonos antiguos, Outlook clásicoiPhone, iCloud, Google Contactspocas apps por ahora

Para saber cuál tienes, abre el archivo en un editor de texto y lee la segunda línea. VERSION:3.0 es la que más vas a encontrar.

Las propiedades que vas a ver

PropiedadQué guardaEjemplo
FNEl nombre tal como debe mostrarseFN:Amélie Lefèvre
NEl nombre en cinco partes: apellido; nombre; adicionales; prefijos; sufijosN:Lefèvre;Amélie;;;
ORGLa empresa y, si hay, el departamentoORG:Northfield Tools;Sales
TITLEEl cargoTITLE:Sales Director
TEL;TYPE=…Un teléfono; los tipos incluyen CELL, WORK, HOME, FAX y VOICETEL;TYPE=WORK,VOICE:+1 555 555 0100
EMAILUna dirección de email, con un tipo opcionalEMAIL;TYPE=WORK:[email protected]
ADRUna dirección postal en siete partes: apartado de correos; ampliada; calle; ciudad; región; código postal; paísADR;TYPE=WORK:;;12 Main St;Springfield;IL;62701;USA
URLUna webURL:https://example.com
NOTETexto libreNOTE:Met at booth 14\, spring show
PHOTOUna imagen, codificada en el archivo o enlazadaPHOTO;ENCODING=b;TYPE=JPEG:/9j/4AAQ…

Los nombres de las propiedades no distinguen mayúsculas, así que tel y TEL significan lo mismo. Las líneas que empiezan por X- son añadidos propios de un fabricante, como X-SOCIALPROFILE. Apple y Google también agrupan un valor con una etiqueta personalizada poniendo el mismo prefijo en las dos líneas: item1.EMAIL:[email protected] e item1.X-ABLabel:Billing van juntas. Un lector que ignora el prefijo obtiene igualmente el email, solo que sin su etiqueta.

El mismo contacto en cada versión

vCard 2.1, con el nombre con tildes en quoted-printable:

BEGIN:VCARD
VERSION:2.1
N;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:Lef=C3=A8vre;Am=C3=A9lie;;;
FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:Am=C3=A9lie Lef=C3=A8vre
TEL;CELL;VOICE:+1 555 555 0142
END:VCARD

vCard 3.0:

BEGIN:VCARD
VERSION:3.0
N:Lefèvre;Amélie;;;
FN:Amélie Lefèvre
TEL;TYPE=CELL:+1 555 555 0142
END:VCARD

vCard 4.0, con el número como enlace tel::

BEGIN:VCARD
VERSION:4.0
FN:Amélie Lefèvre
N:Lefèvre;Amélie;;;
TEL;TYPE=cell;VALUE=uri:tel:+1-555-555-0142
END:VCARD

Plegado de líneas y quoted-printable

Las líneas largas se pliegan. En 3.0 y 4.0, quien escribe el archivo parte una línea larga insertando un salto de línea seguido de un espacio o un tabulador; el RFC 6350 pide líneas de 75 octetos como máximo. Quien lo lee las une borrando el salto de línea y ese carácter, y nada más. Una herramienta que borra también el espacio siguiente, o que conserva el primero, pega dos palabras o mete un espacio en medio de una dirección de email. Una foto en base64 ocupa cientos de líneas plegadas, y por eso un .vcf con imágenes es muchas veces más grande que uno sin ellas.

Quoted-printable es cosa de la 2.1. Cada byte fuera del ASCII básico se convierte en un signo igual y dos dígitos hexadecimales, así que «é» en UTF-8 es =C3=A9. Una línea que termina en = es un salto blando: el valor sigue al principio de la línea siguiente.

Juegos de caracteres y nombres ilegibles

  • Un archivo 2.1 sin CHARSET= se escribía normalmente en la página de códigos local del teléfono o de Windows. Leído como UTF-8, sus tildes se convierten en signos de interrogación.
  • «Ã©» donde debería ir «é» significa lo contrario: un texto UTF-8 leído como Windows-1252, a menudo por Excel.
  • Un archivo 3.0 no indica su juego de caracteres. Las exportaciones actuales escriben UTF-8, y un lector debe suponerlo.
  • Un archivo 4.0 es UTF-8 por definición.
  • En 3.0 y 4.0, una coma, un punto y coma o una barra invertida dentro de un valor se escapan con una barra invertida, y un salto de línea dentro de una nota se escribe \n. Un lector que no lo tiene en cuenta parte un valor en dos.

Convertir entre versiones y a CSV

El conversor de VCF a CSV lee las tres versiones, las líneas plegadas, el texto quoted-printable, las etiquetas item1. y los archivos en UTF-8, UTF-16 o Windows-1252, y escribe un CSV con una fila por contacto. Al revés, crea un archivo vCard 3.0 a partir de un CSV. Funciona en tu navegador y no se sube nada. Las fotos se omiten. Si antes necesitas lo básico, lee qué es un archivo VCF.

Krane para iPhone

Con Krane: vCards a partir de tarjetas de papel

Krane, en iPhone, iPhone Duo y iPad, trabaja desde el otro extremo: lee una tarjeta de visita impresa y la convierte en contacto, y luego la añade a Contactos de Apple o la comparte como vCard. Con Krane Pro también exporta un CSV o envía el contacto a HubSpot, Salesforce o Pipedrive. El escáner de tarjetas de visita es gratis para 10 escaneos a la semana. No puede importar un .vcf.

Un archivo .vcf de contactos que se convierte en filas de una hoja de cálculocontacts.vcfBEGIN:VCARDFN:Amélie L.END:VCARDBEGIN:VCARDFN:山田 太郎END:VCARDBEGIN:VCARDFN:Sam RiveraEND:VCARDNombreEmpresaEmailcontacts.csv3 contactos

Herramienta gratis

Abrir un archivo VCF y convertir VCF a CSV

Abre un archivo .vcf (vCard) para ver todos sus contactos, descárgalos como CSV para Excel, Google Sheets o un CRM, o convierte un CSV en un .vcf. El archivo se queda en tu navegador.

Preguntas frecuentes

Preguntas sobre el formato vCard

¿Qué versión de vCard debo usar?

Escribe 3.0 salvo que el sistema al que envías los datos pida otra cosa. El iPhone, iCloud y Google Contacts la exportan, y todas las apps de contactos la importan. Usa 4.0 cuando el programa que la recibe lo pida. Escribe 2.1 solo para un dispositivo antiguo que no lea nada más nuevo.

¿Un archivo VCF es lo mismo que una vCard?

Sí. vCard es el formato y .vcf es su extensión de archivo habitual; algunos programas usan .vcard. El texto de dentro es el mismo: BEGIN:VCARD, las propiedades, END:VCARD.

¿Por qué los nombres con tildes salen mal después de importar?

El importador leyó el archivo con el juego de caracteres equivocado. «Ã©» significa que un texto UTF-8 se leyó como Windows-1252; los signos de interrogación suelen indicar que un archivo 2.1 en una página de códigos local se leyó como UTF-8. Conviértelo con una herramienta que detecte la codificación, o vuelve a exportar los contactos como vCard 3.0.

¿Qué significa «item1.» en una vCard?

Es un prefijo de grupo. Apple y Google ponen el mismo prefijo en un valor y en la línea que guarda su etiqueta personalizada, como item1.EMAIL e item1.X-ABLabel:Billing, para que la etiqueta vaya con el email correcto. Un programa que no conoce los grupos conserva el email y pierde la etiqueta.

¿Puede una vCard llevar una foto?

Sí. En 2.1 y 3.0 la línea PHOTO lleva la propia imagen, codificada como texto base64, lo que hace el archivo mucho más grande. En 4.0 PHOTO es un URI: un enlace a la imagen, o un URI data: con la imagen dentro.

¿Cuál es el tipo MIME de una vCard?

text/vcard. Los programas antiguos y algunos servidores de correo todavía envían text/x-vcard. La extensión de archivo es .vcf.

Convierte tarjetas impresas en vCards con tu iPhone.

Gratis para 10 escaneos a la semana. Krane Pro añade escaneos ilimitados, exportación y sincronización con tu CRM.

Descárgalo en el App Store
Código QR: Krane en el App Store

¿Estás en un ordenador? Apunta la cámara del iPhone al código o envíame el enlace por SMS.