> For the complete documentation index, see [llms.txt](https://ajuda.botconversa.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.botconversa.com.br/funcionalidades-gerais-botconversa/audiencia/como-importar-contatos.md).

# Como Importar Contatos

Neste vídeo você vai aprender como subir sua base de contatos para a audiência do BotConversa. Isso te permite entrar em contato com todos os seus leads de forma ativa.

{% embed url="<https://youtu.be/JQG4amukRPE>" %}

> ### Resposta rápida <a href="#resposta-rapida" id="resposta-rapida"></a>
>
> Você pode cadastrar contatos de dois jeitos: um por um, pelo botão **Criar Contato**, ou todos de uma vez, importando uma planilha pelo botão **Importar Contatos**. Em ambos é obrigatório confirmar que você tem autorização para falar com essas pessoas pelo WhatsApp.

### Antes de começar <a href="#antes-de-comecar" id="antes-de-comecar"></a>

* Tenha o WhatsApp já conectado ao BotConversa.
* Para importar em massa, prepare uma planilha no formato **.xlsx** (Excel).
* Importante: só importe contatos que **autorizaram** receber suas mensagens. Importar lista comprada ou gente que nunca falou com você viola as regras do WhatsApp e pode bloquear o seu número.

### Passo a passo <a href="#passo-a-passo" id="passo-a-passo"></a>

#### Passo 1: Abra a tela de Contatos <a href="#passo-1-abra-a-tela-de-contatos" id="passo-1-abra-a-tela-de-contatos"></a>

No menu lateral, clique em **Contatos**. É aqui que fica toda a sua base de pessoas. No canto superior direito você encontra três botões: **Importar Contatos**, **Baixe Relatório** e **Criar Contato**.

<figure><img src="https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-1.png" alt="Tela de Contatos com os botoes no canto superior direito"><figcaption><p>Tela de Contatos com os botoes no canto superior direito</p></figcaption></figure>

#### Passo 2A: Cadastrar um contato manualmente <a href="#passo-2a-cadastrar-um-contato-manualmente" id="passo-2a-cadastrar-um-contato-manualmente"></a>

Use este caminho quando for só um contato (por exemplo, um cliente que chegou por indicação).

1. Clique no botão verde **Criar Contato**.
2. Preencha **Primeiro nome** e **Segundo nome**.
3. Confira o país (vem com Brasil 🇧🇷 `+55` por padrão) e digite o **Telefone**.
4. Marque a caixinha de **consentimento**, confirmando que você tem autorização para enviar mensagens a esse contato.
5. Clique em **Criar Contato**.

O contato aparece no topo da lista na hora.

<figure><img src="https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-2.png" alt="Janela de criar contato manual"><figcaption><p>Janela de criar contato manual</p></figcaption></figure>

#### Passo 2B: Importar uma planilha (em massa) <a href="#passo-2b-importar-uma-planilha-em-massa" id="passo-2b-importar-uma-planilha-em-massa"></a>

Use este caminho para trazer uma base inteira de uma vez.

1. Clique em **Importar Contatos**.
2. Baixe o **Modelo** de planilha pelo link da janela. Você também pode abrir o modelo direto no Google Sheets: [**abrir modelo de importação**](https://docs.google.com/spreadsheets/d/1cCy9Ai3yMYPjYuNnFZ9PN2wiCwu-u2uoYSSesU_Haao/edit?gid=0#gid=0) → **Arquivo → Fazer download → Microsoft Excel (.xlsx)**.
3. Preencha o modelo com seus contatos (nome e telefone, no mínimo) e salve no formato **.xlsx**.
4. Arraste o arquivo para a área de upload ou clique para selecioná-lo.
5. Marque a caixinha de **consentimento**.
6. Clique em **Importar contatos**.

<figure><img src="https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-3.png" alt="Janela de importar contatos com area de upload"><figcaption><p>Janela de importar contatos com area de upload</p></figcaption></figure>

**O que cada coluna do modelo significa**

O modelo de importação aceita **apenas 4 colunas**:

| Coluna            | Obrigatória? | O que vai aqui                                                                                                                                                                                                     |
| ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Telefone**      | ✅ Sim        | Número com DDI (ex.: `5511930000123`) ou já com `+`. Sem essa coluna o contato **não** é criado.                                                                                                                   |
| **Primeiro nome** | Recomendado  | Nome do contato. Aparece em mensagens com a variável `{primeiro-nome}`.                                                                                                                                            |
| **Sobrenome**     | Opcional     | Sobrenome — combina com `{sobrenome}` nos fluxos (em inglês: `{last_name}`).                                                                                                                                       |
| **Etiquetas**     | Opcional     | Uma ou mais etiquetas separadas por **vírgula** (ex.: `cliente-vip, sao-paulo`). Etiquetas **inexistentes são criadas automaticamente** no momento da importação; as que já existem, são **aplicadas** ao contato. |

> Não renomeie as colunas do modelo — o parser usa o cabeçalho para mapear cada coluna ao campo certo.

> **A importação não traz e-mail, CPF nem campos personalizados.** Esses dados precisam ser preenchidos depois — no Cartão do Usuário (à mão) ou automaticamente por um fluxo que capture a resposta com o elemento **Salvar**. Veja [Capturando respostas do cliente](https://botconversa-help-center.vercel.app/aula/capturando-respostas-do-cliente).

### Dicas <a href="#dicas" id="dicas"></a>

* Sempre comece pelo **Modelo** que o BotConversa oferece. Assim você garante que as colunas estejam no formato esperado e evita erros na importação.
* Higienize a planilha antes de subir: tire telefones repetidos, números incompletos e linhas em branco. Quanto mais limpa a base, menos problema na hora do disparo.
* O telefone é normalizado automaticamente para o padrão internacional (ex.: `+55 11 93000 0123`). Você pode digitar com ou sem espaços.
* Depois de importar, abra alguns contatos para conferir se nome e número entraram certinhos.

### Casos de uso <a href="#casos-de-uso" id="casos-de-uso"></a>

**Loja online:** você já tinha uma lista de clientes em uma planilha. Baixa o modelo, copia nome e telefone de quem comprou e autorizou contato, e importa tudo de uma vez para começar a enviar promoções.

**Clínica:** a recepcionista cadastra manualmente, pelo **Criar Contato**, cada paciente novo que liga pedindo informações, para depois acompanhá-lo pelo funil de atendimento.

### Perguntas frequentes <a href="#perguntas-frequentes" id="perguntas-frequentes"></a>

<details open>

<summary>Posso importar qualquer lista de contatos que eu tenha?</summary>

Não. Você só deve importar pessoas que autorizaram receber suas mensagens. Listas compradas ou de gente que nunca interagiu com você violam as regras do WhatsApp e colocam seu número em risco de bloqueio. A caixinha de consentimento existe justamente para você confirmar isso.

</details>

<details open>

<summary>Qual formato de arquivo a importação aceita?</summary>

Apenas planilha no formato **.xlsx** (Excel). Use sempre o modelo oferecido na própria tela.

</details>

<details open>

<summary>Qual a diferença entre criar e importar?</summary>

Criar serve para um contato por vez, na mão. Importar serve para trazer vários de uma só vez por planilha. O resultado é o mesmo: os contatos entram na sua base.

</details>

<details open>

<summary>Posso importar e-mail, CPF ou campos personalizados pela planilha?</summary>

**Não.** A importação aceita apenas **Telefone, Primeiro nome, Sobrenome e Etiquetas**. E-mail, CPF e campos personalizados precisam ser preenchidos **depois** — direto no **Cartão do Usuário** (à mão) ou automaticamente por um fluxo com captura de resposta. Veja [Capturando respostas do cliente](https://botconversa-help-center.vercel.app/aula/capturando-respostas-do-cliente).

</details>

<br>


---

# 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://ajuda.botconversa.com.br/funcionalidades-gerais-botconversa/audiencia/como-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.