--- title: "Importando contatos" url: https://ajuda.botconversa.com.br/aula/importando-contatos section: "Organizando clientes" date_modified: 2026-09-06T18:35:20.325155+00:00 language: pt-BR --- # Importando contatos [Vídeo da aula](https://www.youtube.com/watch?v=JQG4amukRPE) **Tempo de leitura:** ~5 min**Para quem é:** Dono do negócio | Gestor | Marketing ## Resposta rápida 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 - 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 ### Passo 1: Abra a tela de Contatos 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**. ![Tela de Contatos com os botoes no canto superior direito](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-1.png) Tela de Contatos com os botoes no canto superior direito ### Passo 2A: Cadastrar um contato manualmente 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. ![Janela de criar contato manual](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-2.png) Janela de criar contato manual ### Passo 2B: Importar uma planilha (em massa) 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**. ![Janela de importar contatos com area de upload](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/05-organizando-clientes/importando-contatos/passo-3.png) Janela de importar contatos com area de upload #### 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](/aula/capturando-respostas-do-cliente). ## Dicas - 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 **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 Posso importar qualquer lista de contatos que eu tenha? 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. Qual formato de arquivo a importação aceita? Apenas planilha no formato **.xlsx** (Excel). Use sempre o modelo oferecido na própria tela. Qual a diferença entre criar e importar? 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. Posso importar e-mail, CPF ou campos personalizados pela planilha? **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](/aula/capturando-respostas-do-cliente).