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

# Contatos e Conversas

> Como importar contatos em massa via planilha e exportar sua base de contatos da LíderHub

## Importar contatos

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

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

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

  <Step title="Baixe o modelo de planilha">
    Clique em **Download do modelo** para obter a planilha no formato correto.
  </Step>

  <Step title="Preencha a planilha">
    Preencha os campos obrigatórios e opcionais:

    | Coluna            | Obrigatória | Descrição                               |
    | ----------------- | ----------- | --------------------------------------- |
    | `nome`            | Sim         | Nome do contato                         |
    | `telefone`        | Sim         | Número com DDI (ex: 5548999991234)      |
    | `status_id`       | Não         | ID do status (obtido nas configurações) |
    | `departamento_id` | Não         | ID do departamento                      |
    | `responsavel_id`  | Não         | ID do responsável                       |
    | `tags`            | Não         | Etiquetas separadas por vírgula         |
    | `origem`          | Não         | Origem do contato                       |
  </Step>

  <Step title="Obtenha os IDs necessários">
    Para preencher `status_id`, `departamento_id` e `responsavel_id`, acesse **Configurações** e copie os IDs de cada item.
  </Step>

  <Step title="Faça o upload">
    Envie a planilha preenchida. O sistema validará os dados e importará os contatos.
  </Step>
</Steps>

### Atualizar contatos via planilha

Para atualizar dados de contatos já existentes, use o mesmo processo. Se o número de telefone já existir, os dados serão atualizados (não duplicados).

<Tip>
  Use a atualização via planilha para alterar status, departamento ou tags de muitos contatos de uma vez.
</Tip>

## Exportar contatos

Você pode exportar todos os contatos do seu workspace em formato de planilha. Útil para backup, análise de dados ou alimentar campanhas de tráfego pago.

<Steps>
  <Step title="Acesse a lista de contatos">
    Na tela de conversas, vá para a aba de **Contatos** ou use a visualização de lista.
  </Step>

  <Step title="Aplique filtros (opcional)">
    Se quiser exportar apenas um segmento, aplique filtros por status, departamento, tags, origem ou período.
  </Step>

  <Step title="Selecione e exporte">
    Use as **ações em massa** para selecionar os contatos desejados e clique em **Exportar planilha**.
  </Step>

  <Step title="Baixe o arquivo">
    O arquivo será gerado e disponibilizado para download em formato CSV ou Excel.
  </Step>
</Steps>

### Dados exportados

| Campo           | Descrição                    |
| --------------- | ---------------------------- |
| Nome            | Nome do contato              |
| Telefone        | Número com DDI               |
| Status          | Status atual no funil        |
| Departamento    | Departamento atribuído       |
| Tags            | Etiquetas do contato         |
| Origem          | Fonte do lead                |
| Responsável     | Membro ou agente responsável |
| Data de criação | Quando o contato foi criado  |

### Casos de uso

* **Backup periódico**: exporte seus contatos regularmente como segurança
* **Análise de funil**: analise taxas de conversão no Excel ou Google Sheets
* **Campanhas de tráfego**: exporte leads qualificados para criar públicos lookalike no Facebook/Google
* **Migração**: exporte para importar em outro workspace ou plataforma

## Deixe uma sugestão

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

  <iframe src="https://tally.so/embed/682q2k?feature=Contatos%20e%20Conversas&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?">
    Não. A importação requer pelo menos um telefone conectado na LíderHub.
  </Accordion>

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

  <Accordion title="A exportação inclui o histórico de mensagens?">
    Não. A exportação de contatos inclui apenas os dados do contato. Para conversas, veja a seção de Importar e Exportar Histórico.
  </Accordion>

  <Accordion title="Posso exportar contatos de todos os workspaces de uma vez?">
    Não. A exportação é por workspace. Exporte cada um separadamente.
  </Accordion>
</AccordionGroup>