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

# Como importar contatos (CSV ou Excel)

> Os três passos da importação: arquivo, mapeamento de colunas e a declaração de consentimento — com como desfazer.

## O que você vai aprender

Como trazer sua base para a Cliqo com os dados nos campos certos e o consentimento declarado corretamente — e como desfazer uma importação que veio errada.

## Antes de começar

* Arquivo **CSV, XLSX ou XLS**, de até 30 MB, com uma coluna de e-mail (obrigatória).
* Se você migrou de outra ferramenta, importe **antes** a blocklist dela em Supressões ([por quê](https://docs.cliqo.io/pt-BR/entregabilidade/checklist-primeiro-envio.md)).

Vá em **Público › Contatos › Importar**. São três passos.

## Passo 1 · Arquivo

Arraste o arquivo (ou clique para selecionar). A Cliqo detecta separador e codificação sozinha.

## Passo 2 · Colunas

No topo deste passo ficam **Separador** e **Codificação** (só para CSV): se os acentos vierem errados na amostra ou as colunas grudarem, troque ali e o arquivo é relido na hora.

Mapeie cada coluna do arquivo para um campo:

* **Email** (obrigatório), **Nome completo** — ou **Primeiro nome** + **Sobrenome**, que a Cliqo junta —, **Telefone / WhatsApp**.
* Colunas extras viram **campos personalizados**: escolha "Criar campo" (ou "Associar ao campo", se a marca já tem esse campo) e o tipo é detectado automaticamente (texto, número, data, sim/não…). Revise as notas de detecção — datas ambíguas e CEPs com zero à esquerda são apontados. Detalhes em [Campos personalizados e tipados](https://docs.cliqo.io/pt-BR/gestao-de-dados/campos-tipados.md).
* O que não interessa: **Ignorar**.

Em **Ajustes da importação**, escolha o modo (**Adicionar e atualizar**, **Só adicionar novos** ou **Só atualizar existentes**) e se uma coluna vazia deve ou não sobrescrever o dado atual do contato.

## Passo 3 · Confirmar — e declarar o consentimento

Aqui você declara o que essa base autorizou: **e-mail marketing** e/ou **WhatsApp marketing**. Leia com atenção antes de marcar:

* A declaração é **sua responsabilidade** (LGPD) — ela fica registrada com data, como origem "importação confirmada pelo cliente".
* **Sem marcar E-mail marketing**, você declara que a base não tem opt-in: esses contatos não recebem nada, e a conta inteira passa a exigir consentimento — toda campanha seguinte exclui quem não tem registro de opt-in, inclusive contatos antigos que hoje recebem. A tela avisa isso antes de você importar.
* **WhatsApp: só marque com prova.** A Meta pune quem envia sem opt-in — bloqueios derrubam a nota do seu número. Na dúvida, importe sem o opt-in de WhatsApp e capture a autorização depois (pop-up, formulário no e-mail).

Escolha a **Lista de destino** (opcional) e clique em **Importar N contatos**. O contexto completo está em [Entenda consentimento e opt-in](https://docs.cliqo.io/pt-BR/gestao-de-dados/entenda-consentimento.md).

## Resultado

O relatório da importação mostra: novos contatos, ignorados por e-mail inválido (com **Baixar ignorados** e **Baixar inválidos**, que trazem cada linha com o motivo — para você corrigir e reimportar), telefones inválidos e quantos entraram com cada opt-in.

Dois comportamentos de proteção, de propósito:

* **Importados não recebem boas-vindas automaticamente** — o fluxo de boas-vindas é para quem acabou de se cadastrar, não para uma base que chegou de mudança. No passo 3, o padrão é **Não enviar boas-vindas**.
* **Importação nunca cria opt-in silencioso** — só a sua declaração explícita destrava marketing.

## Importação veio errada?

Ainda na tela de resultado, antes de fechar, clique em **Desfazer esta importação**: os contatos criados por ela são removidos; quem já existia antes continua como estava, e quem já recebeu alguma campanha é preservado e reportado. Depois corrija o arquivo e importe de novo.

## Artigos relacionados

* [Campos personalizados e tipados](https://docs.cliqo.io/pt-BR/gestao-de-dados/campos-tipados.md)
* [Supressões e blocklist](https://docs.cliqo.io/pt-BR/gestao-de-dados/supressoes.md)


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