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

# Falha no carregamento do ficheiro CSV

> Resolva erros, atrasos e problemas de formatação no carregamento de ficheiros CSV

<Note>
  Se a importação do CSV estiver bloqueada, tiver sido importada apenas parcialmente ou estiver a falhar com erros, este guia ajuda-o a diagnosticar problemas de formatação, atrasos na fila, campos em falta e outras causas comuns.
</Note>

**Nível de utilizador:** Admin

***

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

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

* Importação bloqueada em **Importação de contactos em curso**

* Apenas parte do ficheiro é importada (por exemplo, «352 contactos importados»)

* As colunas personalizadas não são importadas

* O CSV falha repetidamente sem uma causa clara

<h2 id="h_d999f72c5b">
  Causas principais
</h2>

Alguns problemas impedem o início da importação (como cabeçalhos incorretos), enquanto outros podem afetar apenas determinadas linhas ou causar atrasos.

<h3 id="h_00ae6f0320">
  **⚠️** Problemas de formato ou de codificação do ficheiro
</h3>

* Ficheiro não exportado como **CSV UTF-8**

* Ficheiro editado no Excel ou no Numbers, que podem adicionar carateres ocultos

* Tipos de letra não suportados, emojis ou carateres não UTF8

* Separadores errados (ponto e vírgula em vez de vírgula)

* Estrutura danificada, por exemplo:

  * Linhas vazias no meio dos dados

  * Células unidas

  * Blocos de texto soltos acima ou abaixo da tabela

Estes problemas podem fazer com que a importação bloqueie, pare antes do fim ou falhe com um erro genérico do servidor.

<h3 id="h_6509cfd4d4">
  **⚠️** Cabeçalhos em falta ou incorretos
</h3>

A CloudTalk precisa de cabeçalhos específicos para processar o seu CSV.

As importações podem ficar bloqueadas ou falhar se:

* Faltarem colunas obrigatórias (pelo menos `name` e `phone` ou `email`)

* Os nomes dos cabeçalhos não corresponderem exatamente

  (`name` ou `phone` não é o mesmo que `Name` e `Phone`)

* Forem utilizadas colunas personalizadas sem que os atributos personalizados correspondentes tenham sido criados previamente na CloudTalk. Nesse caso, essas colunas podem não ser importadas, mas o resto do ficheiro pode ainda assim ser processado.

<h3 id="h_80029f30a1">
  **⚠️** Formato do número de telefone
</h3>

Se os números de telefone forem inválidos, os contactos afetados podem não ser importados, mas o resto do ficheiro pode ainda assim ser processado.

Problemas típicos:

* Indicativo do país em falta ou incorreto (pode originar uma formatação incorreta do número se o país predefinido não estiver corretamente configurado)

* Carateres adicionais no campo do telefone:

  * Parênteses, traços

  * Texto, emojis ou extensões

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

<h3 id="h_a2f61130e0">
  1. Reconstrua o CSV num formato limpo
</h3>

O método mais seguro:

1. Transfira o modelo CSV da CloudTalk

2. Carregue o modelo para o **Google Sheets**

3. Cole os seus dados no modelo

4. Certifique-se de que a tabela:

   * Começa na primeira linha

   * Não tem células unidas

   * Tem apenas uma linha de cabeçalho

5. Transfira como CSV no Google Sheets:

   **Ficheiro > Transferir > Valores separados por vírgulas (.csv)**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/12930295/f2cda6063676-image.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=8623d193c43a4480ef4f9f0e3f4e2ff4" alt="" width="605" height="603" data-path="images/help-center/articles/12930295/f2cda6063676-image.png" />
   </Frame>

6. Importe este novo ficheiro CSV para a CloudTalk

Normalmente, isto elimina os problemas de codificação e os carateres ocultos provenientes do Excel ou do Numbers.

<Warning>
  Para instruções completas passo a passo sobre a importação, incluindo a transferência do modelo CSV e os passos de importaçã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_9d97c69d39">
  2. Confirme os cabeçalhos das colunas
</h3>

No ficheiro do Google Sheets, verifique:

* Se tem, pelo menos:

  * `Nome`

  * `Telefone` ou `email`

* Se os nomes dos cabeçalhos estão em **minúsculas** e correspondem exatamente aos da CloudTalk

* Se não existem espaços adicionais antes ou depois do texto do cabeçalho

Se utilizar colunas adicionais, certifique-se de que cada coluna personalizada corresponde a um [atributo personalizado](/pt/articles/2144934-custom-attributes) na CloudTalk.

<h3 id="h_ffeb355df1">
  3. Verifique o formato dos números de telefone
</h3>

Verifique algumas linhas de exemplo na coluna `Telefone`:

* Os números de telefone podem ser indicados em formato internacional (E.164), por exemplo: `+14151234567`, ou em formato local (por exemplo, `090886547`).

* Se um número não incluir o indicativo do país, a CloudTalk aplica o indicativo do país predefinido nas definições da sua conta. Para garantir resultados corretos, certifique-se de que o país predefinido está corretamente configurado antes de importar.

* Pode incluir vários números de telefone numa célula, separados por dois pontos (`:`), por exemplo: `+14151234567:+12125550189`

* Remova:

  * Parênteses

  * Traços

  * Texto adicional

* Se um número de telefone não for reconhecido como válido, esse contacto pode não ser importado.

<h3 id="h_c493dc01ca">
  4. Limpe o ficheiro
</h3>

Antes de importar novamente:

* Elimine as linhas vazias no meio e no fim

* Remova os duplicados evidentes

* Separe todas as células unidas

* Remova emojis ou carateres invulgares de `Nome` ou de outros campos

* Remova espaços adicionais no início ou no fim das células

<h3 id="h_75f070750f">
  5. Se utilizar colunas personalizadas
</h3>

Se as colunas adicionais do seu CSV não aparecerem ou parecerem bloquear a importação:

1. Abra **Dashboard > Definições > Geral > Contactos**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Ql3WX5wAKbGZniqk/images/help-center/articles/12930295/08b301a4f442-image.png?fit=max&auto=format&n=Ql3WX5wAKbGZniqk&q=85&s=335f4d7d602b2c40d0d904134fcd2d36" alt="" width="2423" height="1007" data-path="images/help-center/articles/12930295/08b301a4f442-image.png" />
</Frame>

2\. Crie atributos personalizados que correspondam aos nomes das colunas do seu CSV

3\. Certifique-se de que os nomes correspondem exatamente (incluindo maiúsculas e minúsculas)

4\. Guarde e volte a importar o ficheiro

<h3 id="h_ff3eed4beb">
  6. Experimente um ficheiro de teste pequeno
</h3>

Para localizar uma linha problemática específica ou confirmar o problema:

1. Crie uma nova folha com **20–50 linhas** copiadas do seu CSV original

2. Transfira essa folha como CSV

3. Importe este ficheiro pequeno para a CloudTalk

* Se o ficheiro pequeno for importado corretamente, o problema estará provavelmente noutras linhas do ficheiro original

* Se o ficheiro pequeno também ficar bloqueado, o problema está na estrutura, nos cabeçalhos ou na codificação

<h2 id="h_5e0370ed8f">
  Quando contactar o suporte
</h2>

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

* A importação estiver bloqueada há mais de **1 hora**

* O ficheiro estiver limpo e corretamente formatado

* Não aparecerem novas linhas no Histórico de importações

* O novo carregamento também falhar

Anexe:

* O ficheiro CSV

* Capturas de ecrã do Histórico de importações

* A mensagem de erro (se existir)

***

*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

- [Importação de CSV bloqueada](/pt/articles/12958920-csv-import-stuck.md)
- [Como importar contactos para a CloudTalk a partir de um ficheiro](/pt/articles/3422012-how-to-import-contacts-to-cloudtalk-from-a-file.md)
- [Carregamento de utilizadores em massa](/pt/articles/8294955-bulk-upload-users.md)


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