> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# La importación de CSV se queda bloqueada

> Qué hacer cuando la importación de contactos desde un CSV se queda bloqueada o tarda más de lo esperado

<Note>
  Si tu importación de CSV se queda en **Importación de contactos en curso** durante un tiempo inusualmente largo, normalmente significa que el archivo está esperando en la cola de importación o que CloudTalk está tardando más de lo previsto en procesar los datos. Este artículo explica qué ocurre entre bastidores, por qué las importaciones pueden tardar más y qué puedes hacer para resolver el problema.
</Note>

**Nivel de usuario:** Agente

***

<h2 id="h_62c8159f18">
  Síntomas
</h2>

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.

<h2 id="h_67af09f511">
  Cómo funcionan las importaciones de CSV
</h2>

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».

<h2 id="h_fe7266be0e">
  Causas principales
</h2>

<h3 id="h_d0fd740e20">
  ⚠️ Tu importación de CSV está esperando en la cola compartida
</h3>

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.

<h3 id="h_9b526fecff">
  ⚠️ El archivo es grande y necesita más tiempo de procesamiento
</h3>

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.

<h3 id="h_adaedbd0ef">
  ⚠️ El archivo contiene elementos que ralentizan la validación
</h3>

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.

<h3 id="h_300bed95ec">
  ⚠️ El archivo no se puede procesar por problemas de estructura o codificación
</h3>

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](/es/articles/12930295-upload-of-csv-file-fails)**

<Warning>
  Para obtener instrucciones generales sobre cómo preparar un archivo CSV, incluidos los límites de tamaño, las columnas obligatorias y las pautas de formato, consulta **[Cómo importar contactos a CloudTalk desde un archivo](/es/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file)**.
</Warning>

<h3 id="h_45e5562c5f">
  ⚠️ Formato oculto de Excel
</h3>

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.

<h2 id="h_91cd39d4ac">
  Solución paso a paso
</h2>

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

<h3 id="h_2b2d6594a8">
  1. Comprueba si han aparecido contactos nuevos
</h3>

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.

<h3 id="h_a41615c127">
  2. Dale algo de tiempo a la importación
</h3>

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.

<h3 id="h_c65db9606f">
  3. Prueba a subir el archivo fuera de las horas punta
</h3>

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.

<h3 id="h_2de59313b4">
  4. Reduce el tamaño del archivo
</h3>

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

<h4 id="h_b19689aa75">
  Consejos para optimizar las importaciones grandes
</h4>

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

<h4 id="h_a96c5e3582">
  Número máximo de caracteres permitido en las columnas
</h4>

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.

| **Columna** | **Máximo de caracteres** |
| - | - |
| `name` | 150 |
| `zip` | 15 |
| `title` | 255 |
| `company` | 100 |
| `industry` | 100 |
| `website` | 100 |
| `address` | 255 |
| `city` | 255 |
| `state` | 255 |

<h3 id="h_9fef965c1e">
  5. Usa la plantilla CSV de CloudTalk
</h3>

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.

<h3 id="h_c56b361025">
  6. Vuelve a subir el archivo
</h3>

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

<h2 id="h_1740067ad3">
  Alternativas más rápidas a la importación por CSV
</h2>

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.

<h2 id="h_41791894a4">
  Cuándo contactar con atención al cliente
</h2>

Deberías ponerte en contacto con [atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) 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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aquí para ayudarte.


## Related topics

- [Problemas de importación en las Campañas](/es/articles/12931982-campaigns-import-issues.md)
- [Los contactos duplicados se comportan de forma inesperada](/es/articles/12929922-duplicate-contacts-behave-unexpectedly.md)
- [La carga del archivo CSV falla](/es/articles/12930295-upload-of-csv-file-fails.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.