Importar enlaces en masa desde un CSV

Si tiene una hoja de cálculo de URLs de destino que desea acortar todas a la vez — migrando desde otra herramienta, lanzando una campaña, o llenando un nuevo workspace — el importador en masa es el camino correcto. Previsualiza los errores antes de que se confirme nada, para que pueda corregir los problemas sin importaciones parciales.

Formato CSV#

El importador espera un archivo separado por comas con una fila de encabezado. La única columna requerida es destination. Todo lo demás es opcional.

destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact

Reglas de columnas:

• destination (requerida) — la URL completa incluyendo https://. Las URLs sin esquema son rechazadas.
• slug (opcional) — un slug corto personalizado. Solo letras, números y guiones. Si está en blanco, generamos un código aleatorio de 6 caracteres.
• title (opcional) — una etiqueta legible que se muestra en la lista de enlaces.
• tags (opcional) — una o más etiquetas separadas por dos puntos o punto y coma. Las etiquetas se crean automáticamente si no existen.

El orden de las columnas no importa siempre que los nombres del encabezado coincidan. Las columnas adicionales son ignoradas.

Iniciar una importación#

1. Vaya a Tools → Bulk import (o haga clic en el botón de importación desde Links).
2. Suba su archivo CSV. El importador lo analiza y muestra una tabla de vista previa.
3. Revise la vista previa. Cualquier fila con un error está resaltada — pase el cursor sobre el icono de error para ver qué está mal.
4. Haga clic en Import para escribir las filas válidas. Las filas con errores son omitidas.

La importación se ejecuta en segundo plano. Para archivos grandes, un indicador de progreso muestra cuántas filas se han procesado. Recibirá un email de resumen cuando termine.

El límite de 50,000 enlaces#

Cada ejecución de importación está limitada a 50,000 filas. Si su archivo es más grande, divídalo en varios archivos y ejecútelos secuencialmente. No hay límite diario en las ejecuciones de importación.

Deduplicación#

El importador verifica los slugs contra los enlaces existentes. Si el slug de una fila ya existe en el workspace:

• La fila es omitida con un error ("slug already taken").
• El enlace existente no se modifica.

Si la columna de slug está en blanco, siempre generamos un nuevo código único, por lo que las filas con slug en blanco nunca generan conflictos.

Si está reimportando un archivo que ha procesado parcialmente antes, el importador es idempotente para las filas con slug en blanco (cada ejecución crea nuevos enlaces con nuevos códigos). Para slugs explícitos, solo tendrán éxito las filas con slugs que aún no existen en el workspace.

Errores comunes de importación y correcciones#

"Invalid URL" — el destino no incluye un esquema (https://) o contiene caracteres que no son válidos en una URL. Corrija la celda en su hoja de cálculo y vuelva a subir.

"Slug already taken" — existe un enlace con ese slug. Elimine el slug para obtener uno generado automáticamente, o cámbielo por algo único.

"Slug contains invalid characters" — los slugs solo pueden contener letras (a-z, A-Z), números (0-9) y guiones (-). No se permiten espacios, guiones bajos ni puntos.

"File too large" — el archivo excede el límite de 50,000 filas. Divídalo e impórtelo en lotes.

"Destination blocked" — nuestro escáner de URL marcó el destino como malicioso o en una categoría bloqueada. Si cree que esto es un falso positivo, contacte a soporte con la URL.

Solución de problemas#

Mi importación terminó pero faltan algunas filas. Descargue el informe de importación — aparece un enlace en el resumen de importación. El informe muestra qué filas fueron omitidas y por qué. La mayoría de las omisiones son slugs duplicados o URLs inválidas.

El importador dice que el archivo está malformado. Asegúrese de que el archivo sea realmente CSV (no TSV o Excel .xlsx). Ábralo en un editor de texto y confirme que las comas son el delimitador y que la fila del encabezado está presente.

La importación está atascada en "processing". Las importaciones grandes (decenas de miles de filas) pueden tardar unos minutos. Actualice la página para verificar el estado actual. Si sigue atascado después de 10 minutos, contacte a soporte con el ID de importación que se muestra en la URL.