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

> ## Agent Instructions
> Responda sempre em português do Brasil, com os nomes de menus e botões exatamente como aparecem no painel do Notfy.
> Use somente o que está documentado aqui. Se a documentação não cobrir a pergunta, diga isso e indique a página mais próxima em vez de inventar.
> Funcionalidades podem depender do plano, do segmento da empresa, das permissões do usuário e de integrações ativas: cite essa condição quando a página a mencionar.
> Nunca peça nem repita senhas, tokens ou dados pessoais de clientes.

# Importar cadastros por planilha

> Importe clientes, prospecções, contatos de disparo e veículos por CSV no Notfy, usando o modelo da tela e acompanhando as linhas com erro.

As telas de cadastro aceitam arquivos CSV para trazer vários registros de uma vez. O Notfy mostra um modelo de planilha, valida as linhas em segundo plano e informa o que foi importado ou rejeitado.

## Preparar o arquivo

**1. Abra a listagem correspondente**

Use **Importar planilha** em **Clientes**, **Prospecções**, **Veículos** ou dentro de uma lista em **Disparos em Massa**.

**2. Baixe o modelo**

No modal de importação, clique em **Baixar um arquivo CSV de exemplo**. Mantenha os cabeçalhos e preencha uma linha por registro.

**3. Salve em CSV UTF-8**

Não envie a planilha do Excel no formato proprietário. Exporte-a como CSV UTF-8 para preservar acentos.

**4. Envie e confira o resultado**

Selecione o arquivo, escolha o comportamento para registros existentes quando a tela oferecer essa opção e aguarde a notificação **Importação concluída**.

## O que pode ser importado

| Tela | Campos essenciais e exemplos de dados |
| :- | :- |
| **Clientes** | **Nome** é obrigatório. Também aceita documento, telefone, WhatsApp, e-mail, país, endereço, data de nascimento, **Ativo** e observações. |
| **Prospecções** | **Nome** e **WhatsApp / Telefone** são obrigatórios. Também aceita documento, e-mail, etapa do funil, valor estimado, previsão de fechamento, responsável e etiquetas. |
| **Disparos em Massa → Contatos** | **Nome** e **Telefone / E-mail** são obrigatórios. **E-mail** e **Cidade** são opcionais. |
| **Veículos** | **Placa**, **Marca**, **Modelo** e **Ano** são obrigatórios. Também aceita preço, quilometragem, combustível, **Situação**, versão, câmbio, opcionais, chassi, RENAVAM, Código FIPE e observações. |

Os nomes exatos das colunas vêm no arquivo de exemplo da própria tela. Campos obrigatórios e validações podem variar conforme o país e o tipo de cadastro.

## Importar contatos de uma lista de disparo

Em **Atendimento → Disparos em Massa**, abra uma lista e clique em **Importar Contatos**. O arquivo usa **Nome** e **Telefone / E-mail** como colunas obrigatórias; **E-mail** e **Cidade** são opcionais. Baixe o CSV de exemplo no próprio modal.

Em listas de e-mail, o identificador é o e-mail. Em listas de telefone, o Notfy normaliza o número e acrescenta o código do país quando necessário. Depois que a lista foi iniciada, pausada ou concluída, **Importar Contatos** fica indisponível.

## Registros existentes e erros

Nas importações de clientes, prospecções e veículos, a tela permite escolher entre **Ignorar (não alterar o que já existe)** e **Atualizar com os dados da planilha**. Use **Ignorar** quando quiser somente incluir novos registros. Clientes são comparados por documento, WhatsApp ou e-mail; prospecções, por WhatsApp ou documento; veículos, por placa.

Na importação de prospecções, **Disparar automações para os leads importados** começa desligada. Com a opção desligada, o lead não notifica a equipe, não entra em cadências de follow-up e não é distribuído automaticamente.

Ao final, abra o relatório de linhas com problema para corrigir o CSV e importar novamente apenas o que falhou. Uma linha inválida não deve ser tratada como confirmação de que todo o arquivo foi aceito.

> [!NOTE]
>
> As importações de clientes, prospecções e veículos aceitam até 10.000 linhas por arquivo. A importação de contatos de uma lista segue o fluxo próprio exibido no modal.

> [!WARNING]
>
> **Importar Contatos** fica indisponível quando a lista já foi iniciada, pausada ou concluída. Em listas de e-mail, use o e-mail como identificador; em listas de telefone, o Notfy normaliza o número informado.

> [!WARNING]
>
> Revise documentos, telefones e responsáveis antes de enviar. A importação pode criar novos registros e, quando você escolhe atualizar, alterar dados que já estavam cadastrados.

> [card] [Cadastros](https://docs.notfy.ai/cadastros.md)
>
> Entenda como clientes e prospecções se conectam.

> [card] [Disparos em massa](https://docs.notfy.ai/atendimento/listas-envio.md)
>
> Use os contatos importados em uma lista.

> [card] [Veículos](https://docs.notfy.ai/operacao/veiculos.md)
>
> Consulte o cadastro de veículos.


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