Convertidor online gratuito de VCARD a CSV

Muchos sistemas CRM, herramientas de mailing, hojas de cálculo y bases de datos requieren los contactos en forma de tabla en lugar de tarjetas de dirección. Convertir una libreta de direcciones .vcf produce filas editables para la importación masiva, la revisión o el archivado, mientras conserva el archivo de contacto original para su recuperación.

Qué es el formato VCARD

VCARD, que normalmente se almacena con la extensión .vcf, es un formato estructurado para tarjetas de contacto. Los teléfonos, clientes de correo electrónico y aplicaciones de agenda de contactos lo utilizan para almacenar nombres, organizaciones, cargos, números de teléfono, direcciones de correo electrónico, direcciones postales, URL, notas, cumpleaños, fotos y otras propiedades.

Un archivo puede contener una tarjeta exportada desde un dispositivo o muchas tarjetas de una libreta de direcciones completa. Las versiones comunes incluyen vCard 2.1, 3.0 y 4.0. La versión y la aplicación que realiza la exportación afectan a los nombres de las propiedades, la codificación de caracteres, el plegado de líneas y los campos compatibles.

Qué es el formato CSV

CSV, o valores separados por comas, almacena datos tabulares en filas y columnas. Un CSV de contactos normalmente tiene una fila por persona y columnas como Full name, Organization, Phone, Email, Street, City y Postal code.

Excel, Google Sheets, LibreOffice Calc, plataformas CRM, sistemas de mailing masivo, bases de datos y scripts suelen aceptar CSV. Es texto sin formato y fácil de editar o procesar, pero no tiene un esquema universal de contactos. Por lo tanto, un CSV puede omitir o simplificar características de vCard como fotos, categorías, varias direcciones con tipos, relaciones y propiedades personalizadas.

Cómo convertir el archivo

Uso de 101convert.com

1. Abra el convertidor de VCF a CSV en 101convert.com.
2. Seleccione o arrastre el archivo .vcf al convertidor. Un archivo que contenga varias tarjetas debe enviarse como un solo archivo para que cada tarjeta pueda convertirse en una fila independiente de CSV.
3. Inicie la conversión y descargue el archivo .csv resultante. La conversión está disponible sin instalar software.
4. Abra el CSV en Excel, LibreOffice Calc u otra hoja de cálculo. Si aparece un cuadro de diálogo de importación, seleccione UTF-8 y el delimitador utilizado por la salida, normalmente una coma. Algunas configuraciones regionales de hojas de cálculo utilizan punto y coma.
5. Revise varios registros antes de importarlos a otro sistema, incluidos los nombres con acentos, los números de teléfono, las direcciones, los saltos de línea y los registros con varias direcciones de correo electrónico o números de teléfono.

La conversión en línea requiere cargar el archivo de contactos, por lo que debe utilizar un método local cuando la libreta de direcciones contenga datos confidenciales o información de la organización que deba permanecer en el dispositivo.

Uso de un script local de Python

Para datos privados o conversiones por lotes repetibles, instale el analizador de código abierto vobject:

python -m pip install vobject

Guárdelo como vcf_to_csv.py:

import csv
import sys
import vobject

def value(card, name):
    item = getattr(card, name, None)
    return item.value if item else ""

def values(card, name):
    return "; ".join(item.value for item in getattr(card, name + "_list", []))

with open(sys.argv[1], encoding="utf-8-sig") as source, open(
    sys.argv[2], "w", newline="", encoding="utf-8-sig"
) as output:
    fields = ["full_name", "organization", "phone", "email", "street", "city", "region", "postal_code", "country"]
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()

    for card in vobject.readComponents(source):
        address = getattr(card, "adr", None)
        adr = address.value if address else None
        writer.writerow({
            "full_name": value(card, "fn"),
            "organization": value(card, "org"),
            "phone": values(card, "tel"),
            "email": values(card, "email"),
            "street": adr.street if adr else "",
            "city": adr.city if adr else "",
            "region": adr.region if adr else "",
            "postal_code": adr.code if adr else "",
            "country": adr.country if adr else ""
        })

Ejecute el script con los nombres de archivo de entrada y salida:

python vcf_to_csv.py contacts.vcf contacts.csv

Este ejemplo combina varios números de teléfono y direcciones de correo electrónico en una celda y exporta la primera dirección postal. Amplíe la lista de campos y la lógica de extracción si el sistema de destino requiere columnas separadas para los valores móviles, laborales y personales.

Limitaciones de calidad y compatibilidad

Las propiedades de VCARD pueden contener líneas plegadas, texto quoted-printable o UTF-8, comas y puntos y coma escapados, parámetros como TEL;TYPE=CELL y campos repetidos. Utilice un convertidor basado en un analizador; reemplazar directamente las comas o los puntos y coma puede dañar los nombres, las direcciones, las notas y los datos telefónicos.

CSV no puede conservar todas las propiedades de vCard. Las fotos, categorías, notas con saltos de línea, campos personalizados, varias direcciones y etiquetas de tipo pueden descartarse o combinarse. Conserve el archivo original .vcf hasta haber verificado e importado correctamente el CSV.

Al abrir el resultado en una hoja de cálculo, importe las columnas de números de teléfono como texto para que los ceros iniciales, los signos más y las extensiones permanezcan intactos. Compruebe los campos que comiencen por =, +, - o @ antes de abrir datos que no sean de confianza en una hoja de cálculo, ya que algunas aplicaciones pueden interpretarlos como fórmulas en lugar de texto de contacto.