> For the complete documentation index, see [llms.txt](https://fytex.gitbook.io/fyzap/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fytex.gitbook.io/fyzap/contatos/importar-contatos.md).

# Importar contatos

Como Importar Contatos Usando um Arquivo CSV no FyZap

Facilite o cadastro em massa dos seus contatos no FyZap utilizando um arquivo `.csv` no formato correto e atualizado.

***

### 🛠️ **1. Baixe e Edite o Arquivo Modelo**

* 📥 Faça o [**download do arquivo modelo**](https://github.com/cleitonme/Whazing-SaaS/blob/main/docs/importarcontatos/modelo.csv)
* 📝 Ao abrir o arquivo em um editor de texto (ex: **Bloco de Notas**, **Notepad++** ou **VS Code**), ele deve seguir o seguinte formato:

```csv
nome;numero;email;empresa;aniversario;cargo;cidade;observacoes
Maria Silva;55999999999;maria@email.com;ACME Ltda;10/10/1990;Gerente;Florianópolis;Cliente importante
```

* 🔢 **Atenção:** o número de telefone deve incluir o código do país (ex: `55` para Brasil).
* 💾 **Certifique-se de:**
  * Utilizar **ponto e vírgula (`;`)** como separador.
  * Salvar o arquivo no formato **CSV**, codificado em **UTF-8**.

> ⚠️ Se usar o Excel, lembre-se de salvar como **CSV delimitado por ponto e vírgula** (`CSV (Separado por ponto e vírgula) (*.csv)`).

***

### 🧾 **2. Estrutura das Colunas Aceitas**

#### 🎯 **Colunas Obrigatórias**

| Coluna     | Descrição                                         |
| ---------- | ------------------------------------------------- |
| **nome**   | Nome do contato (obrigatório)                     |
| **numero** | Número do WhatsApp (obrigatório, com DDI, ex: 55) |
| **email**  | E-mail do contato (opcional)                      |

***

#### ✨ **Colunas Personalizadas (Exemplos)**

| Coluna                    | Descrição                                                           |
| ------------------------- | ------------------------------------------------------------------- |
| **empresa**               | Nome da empresa                                                     |
| **aniversario**           | Data de aniversário                                                 |
| **cargo**                 | Cargo ou função                                                     |
| **cidade**                | Cidade de residência                                                |
| **observacoes**           | Observações gerais                                                  |
| *(qualquer outra coluna)* | Será salva automaticamente como **Informação adicional** do contato |

💡 **Dica:** Você pode criar **quantas colunas personalizadas quiser**. Todas as colunas adicionais além de `nome`, `numero` e `email` serão automaticamente registradas como **Informações adicionais do contato**.

***

### 🚀 **3. Importando o Arquivo no FyZap**

1. No menu lateral, acesse **Contatos** → **Importar**.
2. Clique em **Selecionar Arquivo** e envie o seu arquivo `.csv`.
3. (Opcional) Configure os dados extras:
   * 🧳 **Carteira:** vincule os contatos a uma carteira específica.(será substituidas pela nova caso contato já exista)
   * 🏷️ **Etiquetas:** adicione etiquetas (tags) aos contatos.(será substituidas pela nova caso contato já exista)
   * 📋 **CRM:** adicione os contatos diretamente a um CRM existente (disponível apenas se o CRM for compartilhado)(será substituidas pela nova caso contato já exista).

📸 Exemplo da tela de importação:

<figure><img src="https://2235870375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFd0S7KpQIO1rClRKQDP%2Fuploads%2Fld07UFLwvpZua8UilHuI%2Fimage.png?alt=media&amp;token=dfe46d84-46b7-4b80-85d5-337fa6d1f12e" alt=""><figcaption></figcaption></figure>

***

### 📌 **Observações Importantes**

✅ O sistema valida e **importa apenas números com WhatsApp ativo**. ✅ Arquivos fora do padrão podem causar falhas na importação. ✅ Revise os dados antes de enviar para **evitar troca de dados de contatos**. ✅ Prefira editores que respeitem a formatação CSV com ponto e vírgula.

> 💬 Em caso de dúvidas, consulte nossa documentação oficial ou entre no grupo de suporte.


---

# 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://fytex.gitbook.io/fyzap/contatos/importar-contatos.md?ask=<question>&goal=<endgoal>
```

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