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

# Importar contatos

> Como importar contatos em massa a partir de um arquivo Excel ou CSV, ou sincronizá-los com o Google Contacts

Neste guia você vai aprender a importar seus contatos no Mindo de forma massiva usando um arquivo Excel ou CSV. Também vai ver as outras opções disponíveis: cadastro manual e sincronização com o Google Contacts.

<iframe width="560" height="315" src="https://www.youtube.com/embed/eHRRucDV_lY" title="Tutorial: Importar contatos no Mindo" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Pré-requisitos

* Ter uma conta ativa no Mindo.
* Ter sua lista de contatos em um arquivo Excel (.xlsx, .xls) ou CSV (.csv).
* Os contatos devem incluir pelo menos **nome** e **telefone** (com código do país).

## Importar a partir de Excel/CSV

<Steps>
  <Step title="Acesse a seção de Contatos">
    No menu lateral, clique em **Contacts** na seção "Administration". Você vai ver sua lista de contatos.
  </Step>

  <Step title="Clique em 'Añadir contactos'">
    No canto superior direito, clique no botão **Añadir contactos**. Uma janela se abre com três abas:

    * **Manual**: para adicionar contatos um por um.
    * **Excel/CSV**: para importar a partir de um arquivo.
    * **Google Contacts**: para sincronizar com sua conta do Google.
  </Step>

  <Step title="Selecione a aba Excel/CSV">
    Clique na aba **Excel/CSV**. Aqui você encontra:

    * **Descargar Plantilla** (Baixar Modelo): fornece um arquivo Excel com o formato correto e as colunas que o Mindo espera.
    * **Subir Archivo** (Enviar Arquivo): a área onde você arrasta ou seleciona seu arquivo.

    <Note>
      Recomendamos baixar o modelo primeiro se esta for sua primeira importação, para garantir que as colunas estejam no formato correto.
    </Note>
  </Step>

  <Step title="Envie seu arquivo">
    Arraste seu arquivo Excel ou CSV para a área de upload, ou clique para selecioná-lo no seu computador. Após o envio, você verá o nome do arquivo e o botão **Abrir vista previa** (Abrir pré-visualização).
  </Step>

  <Step title="Revise a pré-visualização">
    Clique em **Abrir vista previa**. Uma tabela se abre com todos os dados do seu arquivo onde você pode:

    * Verificar o **mapeamento automático de colunas** (Nome completo, E-mail, Telefone, etc.).
    * Adicionar um **prefixo telefônico** se seus números não o incluem (ex: +55).
    * Adicionar um **detalhe de origem** para identificar de onde vêm esses contatos (ex: "Clientes Zona Sul").
    * **Editar dados** diretamente na tabela antes de importar.
    * **Excluir linhas** que você não quer importar.

    <Warning>
      Se alguma coluna não foi mapeada automaticamente, clique no seletor dessa coluna para atribuí-la ao campo correto. Você pode escolher entre campos base e campos personalizados.
    </Warning>
  </Step>

  <Step title="Importe os contatos">
    Quando tudo estiver pronto, clique em **Importar X contactos**. Os contatos são criados imediatamente e aparecem na sua lista com:

    * **Origem**: `csv_import`
    * **Detalhe de Origem**: o nome do arquivo que você usou.
  </Step>
</Steps>

## Outras formas de adicionar contatos

<AccordionGroup>
  <Accordion title="Cadastro manual">
    Na aba **Manual** da janela "Añadir contactos" você pode adicionar contatos um por um, preenchendo nome, e-mail e telefone.
  </Accordion>

  <Accordion title="Google Contacts">
    Na aba **Google Contacts** você pode conectar sua conta do Google para importar contatos automaticamente. O processo tem dois passos:

    1. **Conectar Google Contacts**: autorize o Mindo a acessar sua lista de contatos do Google.
    2. **Programar importação diária**: o Mindo sincroniza seus contatos do Google todos os dias automaticamente.
  </Accordion>
</AccordionGroup>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quais formatos de arquivo posso usar?">
    Você pode usar arquivos Excel (.xlsx, .xls) ou CSV (.csv). O tamanho máximo é de 50 MB. Arquivos grandes são processados em segundo plano.
  </Accordion>

  <Accordion title="Quais colunas meu arquivo precisa ter?">
    As colunas básicas são: `full_name` (nome completo), `email`, `phone` (telefone) e `wpp_phone` (telefone WhatsApp). Nome e telefone são obrigatórios.
  </Accordion>

  <Accordion title="O que acontece se um contato já existe?">
    O Mindo usa o número de telefone para detectar duplicatas. Se um contato com esse telefone já existe, um novo não é criado.
  </Accordion>

  <Accordion title="Posso editar os dados antes de importar?">
    Sim. Na pré-visualização você pode editar qualquer célula diretamente, excluir linhas que não quer importar e ajustar o mapeamento de colunas.
  </Accordion>

  <Accordion title="Para que serve o 'Detalhe de origem'?">
    É uma etiqueta opcional que ajuda a lembrar de onde vieram esses contatos (por exemplo: "Feira Expo 2026", "Clientes Zona Sul"). É salva em cada contato importado.
  </Accordion>

  <Accordion title="Posso importar contatos sem código de país?">
    Sim. Na pré-visualização há um campo para adicionar um prefixo telefônico (ex: +55) a todos os números que não o tenham.
  </Accordion>
</AccordionGroup>