> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/como-realizar-a-importacao-de-contatos-em-massa-lote.md).
# Como realizar a importação de contatos em massa (Lote)
A importação em lote é a ferramenta que elimina o gargalo do cadastro manual, permitindo que você ganhe escala imediata. Ao dominar esse processo, você garante que sua base de dados seja populada com precisão, assegurando que a equipe de atendimento tenha todas as informações necessárias para performar desde o primeiro contato.
### Pré-requisitos
**Permissão necessária:** Adicionar, editar e remover importação de contatos.\
O usuário responsável por executar este tutorial precisa ter ativa a permissão de Importação de contatos. Caso essa opção não esteja disponível no seu perfil, solicite a liberação ao administrador da plataforma antes de prosseguir.
**Preparação do arquivo para importação:** O sucesso da sua importação depende diretamente da qualidade do arquivo utilizado. O Chat Center processa listas em formato CSV para garantir a integridade das informações. Antes de prosseguir com o upload, [acesse o tutorial de como preparar seu arquivo](broken://pages/W8qP3YTJ0rVOiSWUijO2) para garantir que os dados estejam estruturados corretamente.
**Campos adicionais criados:** Os Campos adicionais devem ser criados previamente para que as informações específicas da operação sejam salvas corretamente durante a importação. Se ainda não configurou esses campos, veja como [criar Campos Adicionais ](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-campos-adicionais-para-os-contatos.md)antes de prosseguir com este processo.
#### **1. Importando contatos**
Para acessar a área de importação de contatos, utilize o menu lateral esquerdo e navegue até **Configurações > Importar contatos**, como mostra a imagem abaixo.
Para iniciar um novo processo de importação, clique no ícone **“+”,** localizado no canto inferior direito da tela.
Será exibida uma janela com o processo de importação, conforme ilustrado na imagem abaixo.
O primeiro passo é selecionar o arquivo previamente preparado conforme as [orientações de como gerar um arquivo para importação.](broken://pages/W8qP3YTJ0rVOiSWUijO2) Após um breve processamento, será exibido um modal para que você confirme as configurações do arquivo antes de concluir a importação.
**Selecione o delimitador:** defina o caractere que informa ao sistema onde uma coluna termina e a próxima começa — normalmente vírgula (,) ou ponto e vírgula (;). Essa configuração garante que os dados sejam interpretados corretamente, preservando a organização e evitando falhas na importação.
**Selecione o encapsulamento:** define o caractere (geralmente aspas duplas "") que envolve e protege o conteúdo de uma célula, especialmente quando há vírgulas ou ponto e vírgula no texto.
**Mapa de caracteres:** define a codificação do arquivo (como UTF-8 ou ISO-8859-1), garantindo que acentos e caracteres especiais sejam interpretados corretamente pelo sistema e evitando erros na importação.
{% hint style="warning" %}
**##Dica**
Caso tenha dificuldade ao preencher os campos acima, consulte o [tutorial sobre como criar o arquivo CSV. ](broken://pages/W8qP3YTJ0rVOiSWUijO2)Nele, todas as configurações são explicadas em detalhes para garantir uma importação correta e sem inconsistências.
{% endhint %}
Após definir as configurações do arquivo CSV, você será direcionado para a etapa de Mapeamento. Nessa fase, é necessário indicar em quais campos do Chat Center as informações do arquivo deverão ser salvas, garantindo que cada dado seja direcionado corretamente no sistema.
Normalmente, o de e-mail é reconhecido automaticamente pelo sistema. As demais informações você deve selecionar manualmente. Ao clicar na seta ao lado do título de cada coluna, o sistema exibirá a lista de campos disponíveis. Basta selecionar em qual campo a informação deve ser salva ou escolher a opção “Não importar” caso deseje desconsiderar a coluna.
{% hint style="danger" %}
**##Importante**
Alguns campos exigem uma formatação específica para que o sistema reconheça corretamente as informações. Por isso, valide as orientações no tutorial sobre [como criar o arquivo CSV](broken://pages/W8qP3YTJ0rVOiSWUijO2) e certifique-se de que todos os campos estejam configurados no padrão correto antes de concluir a importação.
{% endhint %}
{% hint style="info" %}
**##Atenção**
Ao visualizar as informações na tela de mapeamento, fique atento a possíveis inconsistências, como nos exemplos abaixo. Elas podem indicar que o arquivo CSV foi configurado incorretamente ou que alguma das opções definidas nas configurações — Delimitador, Encapsulamento ou Mapa de caracteres — não corresponde ao padrão utilizado no arquivo. Validar esses pontos garante uma importação precisa, preserva a integridade dos dados e evita retrabalho na operação.
\
No caso acima, o delimitador de campo foi selecionado incorretamente, o que comprometeu a leitura das colunas pelo sistema.
\
No caso acima, é provável que um delimitador esteja no meio do nome, deslocando o Sobrenome para a coluna de telefone e desorganizando os campos.
{% endhint %}
Após associar os campos às colunas, observe que o sistema altera as cores: o fundo vermelho desaparece e a coluna passa a ficar branca, indicando que o mapeamento está correto. Se todas as colunas estiverem validadas, basta clicar em **“Avançar”** para concluir a etapa.
Observe que a plataforma exige que alguns dados críticos, como número de WhatsApp e e-mail, sejam vinculados aos campos específicos definidos pelo sistema. Identifique esses campos na lista pelo prefixo ID (ex.: **ID:WhatsApp**), conforme ilustrado na imagem abaixo.
Nesse momento, você será redirecionado para a terceira etapa da importação em lote. Agora, é hora de definir as configurações gerais para iniciar a importação.
**Nome da importação:** Defina um nome claro e estratégico para identificar facilmente essa importação na lista futuramente.
**Grupos de contato:** Selecione os grupos de contato que você deseja aplicar a lista que está importando. Você pode selecionar múltiplos grupos e ainda tem a opção de criar um novo grupo clicando no **“+”.**
**Caso o registro exista, aplique as opções abaixo:**
O sistema utiliza o campo de e-mail como identificador único. Se o e-mail já estiver cadastrado na plataforma, você deverá definir como a importação irá combinar os dados existentes com as novas informações que estão sendo enviadas.
* **Não fazer nada:** Nesse caso, o registro (linha) do CSV será ignorado e os dados não serão salvos na plataforma.
* **Preencher caso o valor do campo esteja vazio:** Nesse caso, os dados do CSV serão salvos somente se não existir a informação na plataforma (isso é definido campo a campo).
* **Sobrecrever valores com os do arquivo:** Atualiza os dados do contato com base nas informações presentes no CSV, substituindo os campos correspondentes na plataforma. Caso exista algum dado já cadastrado que não esteja mapeado na importação, ele será mantido.
**Ativar o OPT-IN para todos os contatos:** Ao ativar essa informação, você está dizendo para o sistema que todas as pessoas que estão sendo cadastradas solicitaram o cadastro no seu sistema.
{% hint style="info" %}
**## Informação**
O **Opt-in** é a autorização formal e explícita concedida pelo cliente para receber comunicações da sua marca via canais digitais. Na prática, **apenas usuários com a opção opt-in marcada podem receber contatos ativos da plataforma.**
No ecossistema de mensageria profissional (como a API oficial do WhatsApp), o Opt-in é base da sua **governança e controle operacional.** Ele assegura que sua base é qualificada e realmente interessada, protegendo a performance dos seus envios e a reputação da sua marca.
Marcar contatos como Opt-in sem uma autorização válida pode gerar consequências severas, como bloqueio do número oficial e comprometimento da reputação da sua marca. Se houver qualquer incerteza sobre a origem ou concentimento da base, **mantenha o Opt-in desmarcado** durante a importação. Essa prática protege sua performance e evita riscos desnecessários à sua operação.
{% endhint %}
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**##Dica**
Como a configuração de Opt-in é aplicada globalmente para todo o arquivo durante o processo de upload, você deve separar sua base de contatos em duas planilhas distintas antes de iniciar: uma para usuários que já autorizaram o contato (**Opt-in Ativo**) e outra para aqueles que ainda não o fizeram. Essa organização evita que você conceda permissões indevidas em massa ou bloqueie comunicações legítimas, garantindo que sua operação esteja em total conformidade com as regras de privacidade e protegendo sua conta contra denúncias de spam.
{% endhint %}
Após definir todas as opções, clique no botão **“Iniciar importação”** para dar início ao processamento e cadastrar os registros na plataforma.
Essa tela confirma que o processo de importação foi iniciado. Ao clicar em **“Ver histórico de importação”**, você será direcionado para a lista de importações, onde poderá acompanhar o andamento do processamento e visualizar o resultado.
Na lista de importações você pode ver o resultado do processo:
* **Status:** Estado atual da importação, se está em andamento, se teve alguma falha ou se está completo.
* **Registros:** Corresponde ao total de linhas (contatos) presentes no arquivo CSV importado.
* **Importados:** Quantos novos contatos foram criados.
* **Ignorados:** São os registros que foram ignorados durante o processo.
* **Atualizados:** São os contatos existentes na plataforma que foram atualizados com as informações do CSV.
* **Erros:** Indica quantos registros apresentaram inconsistências e precisam ser corrigidos antes de serem importados. Ao passar o mouse sobre o indicador de status, um tooltip exibirá mais detalhes sobre o motivo do erro, permitindo ajustes rápidos e maior eficiência na validação da base.
Agora, sua lista de contatos na plataforma já estará atualizada com os novos registros importados, garantindo uma base organizada e pronta para uso na sua operação.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/como-realizar-a-importacao-de-contatos-em-massa-lote.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.