La importación de CSV se queda bloqueada

Nivel de usuario: Agente

---

​

Síntomas

Puedes experimentar uno o varios de estos síntomas:

• El estado se mantiene en Importación de contactos en curso durante mucho tiempo
• La pantalla de importación no muestra ningún avance
• Tu archivo sigue en estado de «procesamiento» incluso después de volver a subirlo
• Un archivo parecido se importó rápido antes, pero este tarda más
• Solo una parte del archivo aparece en Contactos, mientras que el resto parece congelado

A veces estos síntomas son temporales y se resuelven automáticamente en cuanto avanza la cola.

​

Cómo funcionan las importaciones de CSV

Cuando subes un archivo CSV, CloudTalk lo procesa en segundo plano. El proceso incluye varios pasos, pero la mayor parte no se ve en la interfaz.

1. CloudTalk comprueba si el archivo cumple los requisitos básicos (formato CSV, límite de tamaño, encabezados obligatorios)
2. El archivo entra en una cola de procesamiento compartida
3. Cuando llega tu turno, CloudTalk procesa el archivo y valida cada fila
4. Los contactos que superan la validación se añaden directamente a tus Contactos

No hay un indicador de progreso paso a paso. En su lugar, verás:

• “Importación de contactos en curso” mientras el archivo espera o se está procesando
• “No pudimos importar tus contactos.” si el sistema no puede procesar el archivo

Si la importación se realiza correctamente, los contactos aparecerán en tu lista de Contactos en cuanto termine el procesamiento. Según el resultado, la importación puede marcarse como completada en la sección de archivos importados. Los contactos simplemente aparecen en tu lista de Contactos una vez que termina el procesamiento. Como las importaciones de CSV se realizan de forma silenciosa en segundo plano, cualquier retraso en la cola se parece mucho a una importación «bloqueada».

​

Causas principales

​

⚠️ Tu importación de CSV está esperando en la cola compartida

Es el motivo más habitual de los retrasos. CloudTalk procesa todas las importaciones de CSV de todos los clientes a través de una única cola compartida siguiendo una regla sencilla: El primero que se sube es el primero que se procesa. Esto significa que:

• Los archivos grandes subidos por otros clientes pueden retrasar tu importación
• Tu archivo puede esperar hasta que terminen las tareas anteriores
• Si tu equipo sube varios CSV, se procesarán estrictamente por orden
• Subir archivos en horas de mucho tráfico puede aumentar el tiempo de espera

Qué puedes notar durante los retrasos de la cola

• El estado se mantiene en Importación de contactos en curso
• No ves aparecer contactos nuevos
• Volver a subir el archivo da como resultado el mismo estado de espera

Este comportamiento es normal en horas punta.

​

⚠️ El archivo es grande y necesita más tiempo de procesamiento

CloudTalk admite archivos CSV de hasta 8 MB. Aunque el archivo esté dentro de este límite, el procesamiento puede tardar más si contiene:

• Un gran número de filas
• Muchas columnas
• Varios campos personalizados
• Valores de texto largos
• Juegos de caracteres complejos o variados

Los archivos más grandes necesitan más tiempo para analizarse y validarse.

​

⚠️ El archivo contiene elementos que ralentizan la validación

La importación puede completarse correctamente pero aun así tardar más si el archivo incluye:

• Números de teléfono que CloudTalk necesita normalizar
• Códigos de país que faltan y requieren gestión automática del prefijo
• Muchos números de teléfono no válidos
• Formatos de columna que CloudTalk necesita interpretar
• Filas muy grandes o complejas
• Espacios en blanco de más alrededor de los valores
• Nombres muy largos o campos de texto libre

Estos elementos no detienen la importación, pero pueden aumentar el tiempo de procesamiento.

​

⚠️ El archivo no se puede procesar por problemas de estructura o codificación

Si la importación no empieza nunca o falla justo después de iniciarse el procesamiento, puede que el archivo tenga problemas de estructura o de codificación. Por ejemplo:

• Codificación incorrecta
• Delimitador equivocado
• Caracteres ocultos o sueltos procedentes de Excel o Numbers
• Filas rotas o vacías dentro de la tabla
• Símbolos o emojis no admitidos
• Nombres de encabezado que no coinciden con los requisitos de CloudTalk
• Columnas obligatorias que faltan (name y al menos una de estas: phone o email)
• Encabezados con mayúsculas en lugar del formato en minúsculas requerido

Este problema se trata con más detalle en Falla la subida del archivo CSV

​

⚠️ Formato oculto de Excel

Aunque el archivo parezca correcto a simple vista, Excel o Numbers pueden añadir formato oculto que ralentiza el procesamiento:

• Caracteres ocultos
• Formato copiado de otras hojas de cálculo
• Delimitadores de más
• Símbolos codificados
• Columnas vacías invisibles

Estos problemas suelen hacer que las importaciones sean más lentas o que parezcan bloqueadas, aunque al final se completen.

​

Solución paso a paso

Estos son los pasos prácticos que te ayudarán a saber si la importación está realmente bloqueada o simplemente esperando su turno.

​

1. Comprueba si han aparecido contactos nuevos

Como CloudTalk no muestra el progreso detallado de la importación, la forma más sencilla de comprobar si avanza es:

1. Ve a Contactos
2. Busca varios contactos de tu archivo
3. Actualiza la página de Contactos

Si empiezan a aparecer contactos nuevos, la importación está avanzando.

​

2. Dale algo de tiempo a la importación

En periodos de mucha actividad, las importaciones de CSV pueden tardar más de lo habitual. El tiempo de espera depende de cuántos archivos CSV se estén procesando en ese momento en todos los espacios de trabajo de CloudTalk. Aunque parezca que nada cambia en la interfaz, el sistema sigue procesando en segundo plano. La mayoría de las importaciones empiezan automáticamente en cuanto terminan los archivos anteriores.

​

3. Prueba a subir el archivo fuera de las horas punta

Si trabajas con archivos CSV de forma habitual:

• Prueba a subirlos a primera hora de la mañana o a última hora de la tarde
• Evita subir varios archivos grandes seguidos
• Evita las horas punta de tu equipo o de tu espacio de trabajo

Esto suele acelerar el inicio de la importación.

​

4. Reduce el tamaño del archivo

CloudTalk permite importar archivos CSV grandes, incluidos archivos con decenas de miles de filas. Sin embargo, los conjuntos de datos muy grandes necesitan más tiempo de procesamiento. Como norma general:

• Los archivos más grandes (por ejemplo, de más de 5 MB) pueden tardar más en procesarse
• Los archivos con cientos de miles de filas deberían dividirse en lotes más pequeños
• En importaciones enormes (por ejemplo, de 250,000+ filas), dividir los datos en varios archivos mejorará mucho el rendimiento y reducirá la probabilidad de que se agote el tiempo de espera

​

Consejos para optimizar las importaciones grandes

Para que tu importación se procese más rápido:

• Elimina las columnas que no necesites
• Acorta los campos de texto libre largos
• Reduce el número de atributos personalizados (si no son necesarios)
• Divide los archivos muy grandes en varios archivos CSV más pequeños
  • Ejemplo: en lugar de un archivo con 200,000 filas, usa cuatro archivos de 50,000 filas

​

Número máximo de caracteres permitido en las columnas

Cada campo de CloudTalk tiene un número máximo de caracteres permitido. Superar estos límites puede provocar errores de importación o que el campo se trunque.

​

5. Usa la plantilla CSV de CloudTalk

Si tu importación nunca avanza o siempre se queda bloqueada en el mismo punto:

1. Descarga la plantilla CSV de CloudTalk
2. Ábrela en Google Sheets
3. Copia tus datos en la plantilla
4. Expórtala como CSV (UTF-8)
5. Prueba a importarla de nuevo

Google Sheets limpia automáticamente el formato oculto.

​

6. Vuelve a subir el archivo

A veces volver a subir el archivo ayuda si la subida anterior falló o se hizo en un momento de tráfico alto, pero no garantiza una mejor posición en la cola. Resulta especialmente útil si:

• Subiste el archivo en un momento de tráfico alto
• Otra importación estaba bloqueando la cola
• Hiciste cambios en el archivo

​

Alternativas más rápidas a la importación por CSV

Si gestionas grandes volúmenes de datos de contactos con regularidad, el CSV puede no ser la opción más rápida. Ten en cuenta estas alternativas:

• Integraciones nativas HubSpot, Salesforce, Pipedrive, Zoho y otras sincronizan los contactos automáticamente y se saltan la cola de CSV.
• API de CloudTalk Ideal para importaciones grandes o frecuentes. El endpoint Bulk Requests admite operaciones de alto rendimiento.
• Zapier o Make La mejor opción para fuentes dinámicas como Google Sheets. Una vez configurado, las actualizaciones llegan a CloudTalk automáticamente.

​

Cuándo contactar con atención al cliente

Deberías ponerte en contacto con atención al cliente si:

• La importación se queda en Importación de contactos en curso más de una hora
• La importación no empieza nunca, ni siquiera en horas de poco tráfico
• Volver a subir el archivo da el mismo resultado
• No aparece ningún contacto tras varios intentos
• El archivo se queda parado siempre, incluso dividido en partes más pequeñas

Incluye:

• Tu archivo CSV
• Una captura de pantalla de la ventana de importación, si la tienes
• La hora aproximada de la subida
• El tamaño del archivo

---

¿Necesitas ayuda o tienes alguna pregunta? Escríbenos a través de nuestro Portal de atención al cliente — estamos aquí para ayudarte.