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

# Importação de CSV bloqueada

> O que fazer quando a importação do CSV de contactos fica bloqueada ou demora mais do que o esperado

<Note>
  Se a importação do seu CSV permanecer em **Importação de contactos em curso** durante um período invulgarmente longo, isso significa normalmente que o ficheiro está à espera na fila de importação ou que a CloudTalk está a demorar mais tempo do que o previsto a processar os dados. Este artigo explica o que acontece nos bastidores, porque é que as importações podem demorar mais tempo e o que pode fazer para resolver o problema.
</Note>

**Nível de utilizador:** Agente

***

<h2 id="h_62c8159f18">
  Sintomas
</h2>

Pode verificar uma ou mais das seguintes situações:

* O estado mantém-se em **Importação de contactos em curso** durante muito tempo

* O ecrã de importação não mostra qualquer progresso

* O seu ficheiro continua no estado “em processamento” mesmo depois de voltar a carregá-lo

* Um ficheiro semelhante foi importado rapidamente antes, mas este demora mais tempo

* Só uma parte do ficheiro aparece em Contactos, enquanto o resto parece bloqueado

Por vezes, estes sintomas são temporários e resolvem-se automaticamente assim que a fila avança.

<h2 id="h_67af09f511">
  Como funcionam as importações de CSV
</h2>

Quando carrega um ficheiro CSV, a CloudTalk processa-o em segundo plano. O processo inclui vários passos, mas a maior parte não é visível na interface.

1. A CloudTalk verifica se o ficheiro cumpre os requisitos básicos

   (formato CSV, limite de tamanho, cabeçalhos obrigatórios)

2. O ficheiro entra numa fila de processamento partilhada

3. Quando chega a sua vez, a CloudTalk processa o ficheiro e valida cada linha

4. Os contactos que passam na validação são adicionados diretamente aos seus Contactos

Não existe um indicador de progresso passo a passo.

Em vez disso, verá:

* **"Importação de contactos em curso"** enquanto o ficheiro está à espera ou a ser processado

* **"Não foi possível importar seus contatos."** se o sistema não conseguir processar o ficheiro

Se a importação for bem-sucedida, os contactos aparecerão na sua lista de Contactos assim que o processamento terminar. Consoante o resultado, a importação pode ser assinalada como concluída na secção Ficheiros importados. Os contactos simplesmente aparecem na sua lista de Contactos assim que o processamento terminar.

Como as importações de CSV decorrem discretamente em segundo plano, qualquer atraso na fila parece muito semelhante a uma importação “bloqueada”.

<h2 id="h_fe7266be0e">
  Causas de raiz
</h2>

<h3 id="h_d0fd740e20">
  ⚠️ A sua importação de CSV está à espera na fila partilhada
</h3>

Esta é a razão mais comum para os atrasos.

A CloudTalk processa todas as importações de CSV de todos os clientes através de uma única fila partilhada, com base numa regra simples:

**O primeiro a ser carregado é o primeiro a ser processado.**

Isto significa que:

* Ficheiros grandes carregados por outros clientes podem atrasar a sua importação

* O seu ficheiro pode ficar à espera até que as tarefas anteriores terminem

* Se a sua equipa carregar vários CSV, estes serão processados rigorosamente por ordem

* Carregar ficheiros em horas de maior tráfego pode aumentar o tempo de espera

**O que pode notar durante os atrasos na fila**

* O estado mantém-se em **Importação de contactos em curso**

* Não vê novos contactos a aparecer

* Voltar a carregar o ficheiro resulta no mesmo estado de espera

Este comportamento é normal em períodos de maior utilização.

<h3 id="h_9b526fecff">
  ⚠️ O ficheiro é grande e exige mais tempo de processamento
</h3>

A CloudTalk suporta ficheiros CSV até **8 MB**.

Mesmo quando o ficheiro está dentro deste limite, o processamento pode demorar mais tempo se contiver:

* Um grande número de linhas

* Muitas colunas

* Vários campos personalizados

* Valores de texto longos

* Conjuntos de carateres complexos ou variados

Os ficheiros maiores exigem mais tempo para serem analisados e validados.

<h3 id="h_adaedbd0ef">
  ⚠️ O ficheiro contém elementos que tornam a validação mais lenta
</h3>

A importação pode ser concluída com êxito, mas ainda assim demorar mais tempo se o ficheiro incluir:

* Números de telefone que a CloudTalk precisa de normalizar

* Indicativos de país em falta, que exigem o tratamento automático do prefixo

* Muitos números de telefone inválidos

* Formatos de coluna que a CloudTalk precisa de interpretar

* Linhas muito grandes ou complexas

* Espaços adicionais à volta dos valores

* Nomes muito longos ou campos de texto livre

Estes elementos não impedem a importação, mas podem aumentar o tempo de processamento.

<h3 id="h_300bed95ec">
  ⚠️ O ficheiro não pode ser processado devido a problemas de estrutura ou codificação
</h3>

Se a importação nunca começar, ou falhar imediatamente depois de o processamento se iniciar, o ficheiro pode conter problemas de estrutura ou de codificação.

Por exemplo:

* Codificação incorreta

* Delimitador errado

* Carateres ocultos ou perdidos provenientes do Excel ou do Numbers

* Linhas danificadas ou vazias dentro da tabela

* Símbolos ou emojis não suportados

* Nomes de cabeçalho que não correspondem aos requisitos da CloudTalk

* Colunas obrigatórias em falta (`name` e pelo menos uma de: `phone` ou `email`)

* Cabeçalhos com letras maiúsculas em vez do formato em minúsculas exigido

Este problema é abordado de forma mais aprofundada em **[O carregamento do ficheiro CSV falha](/pt/articles/12930295-upload-of-csv-file-fails)**

<Warning>
  Para instruções gerais sobre como preparar um ficheiro CSV, incluindo limites de tamanho do ficheiro, colunas obrigatórias e regras de formatação, consulte **[Como importar contactos para a CloudTalk a partir de um ficheiro](/pt/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file)**.
</Warning>

<h3 id="h_45e5562c5f">
  ⚠️ Formatação oculta do Excel
</h3>

Mesmo que o ficheiro pareça correto visualmente, o Excel ou o Numbers podem adicionar formatação oculta que torna o processamento mais lento:

* Carateres ocultos

* Formatação copiada de outras folhas de cálculo

* Delimitadores adicionais

* Símbolos codificados

* Colunas vazias invisíveis

Estes problemas tornam muitas vezes as importações mais lentas ou fazem com que pareçam bloqueadas, mesmo que acabem por ser concluídas.

<h2 id="h_91cd39d4ac">
  Solução passo a passo
</h2>

Seguem-se passos práticos que o ajudam a identificar se a importação está realmente bloqueada ou apenas à espera da sua vez.

<h3 id="h_2b2d6594a8">
  1. Verifique se apareceram novos contactos
</h3>

Como a CloudTalk não apresenta o progresso detalhado da importação, a forma mais simples de verificar se a importação está a avançar é:

1. Aceda a **Contactos**

2. Procure vários contactos do seu ficheiro

3. Atualize a página Contactos

Se começarem a aparecer novos contactos, a importação está a progredir.

<h3 id="h_a41615c127">
  2. Dê algum tempo à importação
</h3>

Em períodos de maior atividade, as importações de CSV podem demorar mais tempo do que o habitual.

O tempo de espera depende do número de ficheiros CSV que estão a ser processados nesse momento em todos os espaços de trabalho da CloudTalk.

Mesmo que nada pareça mudar na interface, o sistema continua a processar em segundo plano. A maioria das importações inicia-se automaticamente assim que os ficheiros anteriores terminam.

<h3 id="h_c65db9606f">
  3. Tente carregar fora das horas de maior atividade
</h3>

Se trabalha regularmente com ficheiros CSV:

* Tente carregar os ficheiros de manhã cedo ou ao final do dia

* Evite carregar vários ficheiros grandes seguidos

* Evite as horas de pico da sua equipa ou do seu espaço de trabalho

Isto acelera muitas vezes o início da importação.

<h3 id="h_2de59313b4">
  4. Reduza o tamanho do ficheiro
</h3>

A CloudTalk suporta a importação de ficheiros CSV grandes, incluindo ficheiros com **dezenas de milhares de linhas**. No entanto, conjuntos de dados muito grandes exigem mais tempo de processamento. Como orientação geral:

* Ficheiros maiores (por exemplo, acima de **5 MB**) podem demorar mais tempo a processar

* Ficheiros com **centenas de milhares de linhas** devem ser divididos em lotes mais pequenos

* No caso de importações extremamente grandes (por exemplo, **250,000+ linhas**), dividir os dados em vários ficheiros melhora significativamente o desempenho e reduz a probabilidade de esgotamento do tempo limite

<h4 id="h_b19689aa75">
  Sugestões para otimizar importações grandes
</h4>

Para que a sua importação seja processada mais depressa:

* Remova as colunas de que não precisa

* Encurte os campos longos de texto livre

* Reduza o número de atributos personalizados (se não forem necessários)

* Divida os ficheiros muito grandes em vários ficheiros CSV mais pequenos

  * Exemplo: em vez de um ficheiro com 200,000 linhas, utilize quatro ficheiros de 50,000 linhas

<h4 id="h_a96c5e3582">
  Número máximo de carateres permitido nas colunas
</h4>

Cada campo na CloudTalk tem um número máximo de carateres permitido. Exceder estes limites pode causar erros de importação ou o truncamento do campo.

| **Coluna** | **Máx. de carateres** |
| - | - |
| `name` | 150 |
| `zip` | 15 |
| `title` | 255 |
| `company` | 100 |
| `industry` | 100 |
| `website` | 100 |
| `address` | 255 |
| `city` | 255 |
| `state` | 255 |

<h3 id="h_9fef965c1e">
  5. Utilize o modelo CSV da CloudTalk
</h3>

Se a sua importação nunca avança ou fica sempre bloqueada no mesmo ponto:

1. Transfira o modelo CSV da CloudTalk

2. Abra-o no Google Sheets

3. Copie os seus dados para o modelo

4. Exporte como CSV (UTF-8)

5. Tente importar novamente

O Google Sheets limpa automaticamente a formatação oculta.

<h3 id="h_c56b361025">
  6. Volte a carregar o ficheiro
</h3>

Por vezes, voltar a carregar o ficheiro pode ajudar se o carregamento anterior falhou ou ocorreu num período de tráfego intenso, mas não garante uma posição mais avançada na fila.

Isto é especialmente útil se:

* Carregou o ficheiro num momento de tráfego intenso

* Outra importação estava a bloquear a fila

* Fez alterações ao ficheiro

<h2 id="h_1740067ad3">
  Alternativas mais rápidas à importação de CSV
</h2>

Se lida regularmente com grandes volumes de dados de contactos, o CSV pode não ser a opção mais rápida. Considere:

* **Integrações nativas**

  O HubSpot, o Salesforce, o Pipedrive, o Zoho e outros sincronizam os contactos automaticamente e não passam pela fila de CSV.

* **API da CloudTalk**

  Ideal para importações grandes ou frequentes. O endpoint Bulk Requests suporta operações de elevado volume.

* **Zapier ou Make**

  A melhor opção para fontes dinâmicas como o Google Sheets. Depois de configurado, as atualizações chegam automaticamente à CloudTalk.

<h2 id="h_41791894a4">
  Quando contactar o Suporte
</h2>

Deve contactar o [Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) se:

* A importação permanecer em **Importação de contactos em curso** durante mais de uma hora

* A importação nunca começar, mesmo em horas de pouco tráfego

* Voltar a carregar o ficheiro produzir o mesmo resultado

* Não aparecer nenhum contacto após várias tentativas

* O ficheiro ficar sistematicamente parado, mesmo quando dividido em partes mais pequenas

Inclua:

* O seu ficheiro CSV

* Uma captura de ecrã da **janela de importação**, se disponível

* A hora aproximada do carregamento

* O tamanho do ficheiro

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Como importar contactos para a CloudTalk a partir de um ficheiro](/pt/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file.md)
- [Como importar contactos para a CloudTalk](/pt/articles/2145547-how-to-import-contacts-into-cloudtalk.md)
- [Contactos duplicados com comportamento inesperado](/pt/articles/12929922-duplicate-contacts-behave-unexpectedly.md)


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