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

# Importar Contatos

> Como importar e atualizar contatos em massa via planilha na LíderHub

## Visão geral

Você pode importar contatos em massa para a LíderHub usando uma planilha CSV ou Excel. Isso é útil para migrar de outra plataforma ou para cadastrar uma base de leads existente.

<Warning>
  A importação só funciona se você já tiver um **telefone conectado** na LíderHub.
</Warning>

## Como importar contatos

<Frame caption="Para acessar a área de importação, siga o passo a passo da foto, ou acesse pelo link: [chat.liderhub.ai/import-contacts](https://chat.liderhub.ai/import-contacts)">
  <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/importar-contatos-massa.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=9888d924470696bf290327f1ad0a5410" alt="Importar contatos em massa na LíderHub" width="1024" height="612" data-path="images/importar-contatos-massa.png" />
</Frame>

<Steps>
  <Step title="Acesse a importação">
    Na aba de conversas, clique no botão **Importar contatos em massa** no canto superior direito.

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/nova-importacao.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=0b2f5050666ce334eae516a9345cb91c" alt="Tela de importação de contatos na LíderHub" width="1024" height="610" data-path="images/nova-importacao.png" />
    </Frame>
  </Step>

  <Step title="Escolha o WhatsApp e importe a planilha">
    Clique em **Nova Importação**, selecione um [WhatsApp já conectado](/whatsapp/conectar) e envie sua planilha CSV. Todos os contatos importados serão associados ao WhatsApp selecionado.

    <Frame>
      <img src="https://mintcdn.com/liderhub/L8a6FTHRiAd-xwgQ/images/upload-importacao-contatos.png?fit=max&auto=format&n=L8a6FTHRiAd-xwgQ&q=85&s=1ec8caa7e10cad0f985d2653a5b7d22b" alt="Upload de arquivo CSV para importação de contatos na LíderHub" width="1452" height="1424" data-path="images/upload-importacao-contatos.png" />
    </Frame>

    ### Entenda as colunas da planilha

    <Tip>
      Baixe o modelo de planilha exemplo: [exemplo-importacao.csv](/files/exemplo-importacao.csv)
    </Tip>

    | Coluna                                                                       | Descrição                               |
    | ---------------------------------------------------------------------------- | --------------------------------------- |
    | <Tooltip tip="Esta coluna é obrigatória na planilha">`nome` \*</Tooltip>     | Nome do contato                         |
    | <Tooltip tip="Esta coluna é obrigatória na planilha">`telefone` \*</Tooltip> | Número com DDI (ex: 5548999991234)      |
    | `status`                                                                     | ID do status                            |
    | `departamento`                                                               | ID do departamento                      |
    | `origem`                                                                     | ID da origem                            |
    | `tags`                                                                       | ID das etiquetas, separado por vírgulas |
    | `responsavel`                                                                | ID do responsável                       |
    | `observacao`                                                                 | Observação livre sobre o contato        |

    <Accordion title="Como obter IDs">
      Para obter os IDs, acesse a página de cada propriedade em **Configurações > Classes** e clique em **Copiar ID** no menu de opções.

      Utilize estes IDs na planilha. Considere o [exemplo de planilha](/files/exemplo-importacao.csv).

      <Frame>
        <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/copiar-id-propriedades.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=d9bb1158a09f1ae6ab6b692c15881bed" alt="Como copiar o ID de uma propriedade na LíderHub" width="1024" height="610" data-path="images/copiar-id-propriedades.png" />
      </Frame>

      * [Status](/atendimento/status)
      * [Departamento](/atendimento/departamento)
      * [Etiquetas](/atendimento/etiquetas)
      * [Origem](/atendimento/origem)
      * [Responsável](/atendimento/responsavel)
    </Accordion>
  </Step>

  <Step title="Faça match das colunas">
    Faça match das colunas da planilha com as [propriedades](/atendimento/propriedades) da LíderHub.

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/mapear-colunas-importacao.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=f9bdfab853d93610b189c040570ab82a" alt="Mapeamento de colunas da planilha com propriedades da LíderHub" width="1268" height="1462" data-path="images/mapear-colunas-importacao.png" />
    </Frame>

    <Check>
      Dica: Para cada contato adicionado, você pode adicionar uma [nota interna](/atendimento/notas-internas).
    </Check>
  </Step>

  <Step title="Tudo certo!">
    Sua importação será finalizada em até 2 minutos.

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/importacao-concluida.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=0f707d80fcdf414c10cccb54fe76ea5e" alt="Importação de contatos concluída na LíderHub" width="1416" height="1137" data-path="images/importacao-concluida.png" />
    </Frame>

    Você poderá acompanhar suas importações na página [chat.liderhub.ai/import-contacts](https://chat.liderhub.ai/import-contacts). Para cada importação, você também pode baixar um arquivo CSV com os erros encontrados:

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/historico-importacoes.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=640f0adabb1827498239074482c1eea4" alt="Histórico de importações com opção de baixar erros na LíderHub" width="1024" height="555" data-path="images/historico-importacoes.png" />
    </Frame>

    <Warning>
      Erros na importação acontecem se:

      * WhatsApp não existe, ou formato inválido
      * O chat já existe na LíderHub

      Baixe o [exemplo de arquivo de erros](/files/exemplo-erros.csv) para entender o formato. Você pode obter mais detalhes do seu caso ao tentar importar uma vez.
    </Warning>
  </Step>
</Steps>

## Como atualizar contatos via planilha

<Warning>
  Hoje **não** é possível atualizar dados de contatos existentes via planilha.
</Warning>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre Editar Contatos via Planilha">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=Editar%20Contatos%20via%20Planilha&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="Posso importar contatos sem telefone conectado?">
    Sim, desde que você tenha conectado um WhatsApp pelo menos uma vez.
  </Accordion>

  <Accordion title="A importação cria contatos duplicados?">
    Se os dados já existem, não são atualizados. Duplicados podem ocorrer se o formato do telefone for diferente.
  </Accordion>

  <Accordion title="Erro na importação">
    Verifique se todos os telefones estão no formato correto (DDI + DDD + número, sem espaços ou caracteres especiais). Exemplo: `5548999991234`.

    Revise também os IDs das propriedades. Veja [como obter IDs](#como-obter-ids).
  </Accordion>

  <Accordion title="IDs de status não encontrados">
    Acesse **Configurações > Status** e copie o ID correto. Cada workspace tem seus próprios IDs. Veja [como obter IDs](#como-obter-ids).
  </Accordion>
</AccordionGroup>