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

# Visão Geral de Leads

> Gerencie os contatos das suas campanhas com leads principais, contatos secundários e variáveis personalizadas 

Os **leads** são os contatos que suas campanhas irão chamar.\
Cada lead pode ter **vários números de telefone** (contatos secundários) e **variáveis personalizadas** que seu assistente de IA pode usar durante as conversas.

## O que são Leads?

Os leads representam as **pessoas ou empresas** que você deseja contatar por meio das suas campanhas.\
O sistema de leads oferece suporte a:

<CardGroup cols={2}>
  <Card title="Contatos Principais" icon="user">
    **Contato principal de cada lead**

    O **número de telefone principal** e as **informações de contato** do lead.
  </Card>

  <Card title="Contatos Secundários" icon="users">
    **Números de telefone adicionais para o mesmo lead**

    Contatos de **backup**, **tomadores de decisão** ou **números alternativos**.
  </Card>

  <Card title="Variáveis Personalizadas" icon="code">
    **Informações personalizadas para conversas da IA**

    **Nomes**, **preferências**, **histórico** ou qualquer dado que o assistente precise.
  </Card>

  <Card title="Acompanhamento de Status" icon="chart-line">
    **Monitoramento de progresso ao longo do ciclo da campanha**

    Acompanhe as **tentativas de chamadas**, **conclusões** e o **status de novas tentativas**.
  </Card>
</CardGroup>

## Sistema de Status de Leads

Cada lead passa por diferentes **status** durante a execução da campanha:

<AccordionGroup>
  <Accordion title="Criado" icon="plus">
    **Pronto para chamar** – Lead está na fila para a primeira tentativa de contato.
  </Accordion>

  <Accordion title="Agendado" icon="calendar">
    **Atualmente em chamada** – Chamada em andamento.
  </Accordion>

  <Accordion title="Processamento" icon="phone">
    **Em andamento** – Chamada em progresso.
  </Accordion>

  <Accordion title="Reagendado" icon="clock">
    **Aguardando nova tentativa** – Será chamado novamente após o intervalo configurado para repetição.
  </Accordion>

  <Accordion title="Máximo de Tentativa" icon="ban">
    **Limite de tentativas atingido** – Número máximo de tentativas de chamada excedido.
  </Accordion>

  <Accordion title="Completo" icon="check">
    **Contato bem-sucedido** – Chamada concluída ou objetivo alcançado.
  </Accordion>
</AccordionGroup>

## Contatos Primários vs Contatos Secundários

### Contatos Primários

* Registro principal do lead com informações completas
* Primeiro a ser chamado na sequência da campanha
* Herda as variáveis da campanha definidas nas configurações do assistente
* Controla o status geral do lead e sua conclusão

### Contatos Secundários

* Números de telefone adicionais da mesma pessoa ou empresa
* Chamados se o contato principal não atender (com base nas configurações de repetição da campanha)
* Possuem **acompanhamento de status independente** do contato principal
* Podem ter **variáveis exclusivas**, diferentes do contato principal

<Tip>
  **Exemplo de caso de uso:** um lead comercial pode ter o **número do escritório principal** como contato primário, e o **ramal direto** e o **celular do tomador de decisão** como contatos secundários.
</Tip>

## Sistema de Variáveis

As **variáveis** personalizam as conversas da IA com informações específicas de cada lead.\
Elas são herdadas da configuração do assistente e podem ser **personalizadas por lead**.

**Uso nas conversas:** o assistente utiliza variáveis como  e  para respostas personalizadas.

### **Principais Recursos**

### **Gerenciamento de Leads**

* Criação manual ou importação via **CSV/Excel** com validação
* Acompanhamento de status ao longo do ciclo da campanha
* Recursos de exportação com opções de filtro

### **Integração com Campanhas**

* Um lead pode ser atribuído a **apenas uma campanha por vez**
* Atualizações automáticas de status com base nos resultados das chamadas
* Controle manual de status para gerenciamento da campanha

### Boas Práticas

* **Formato de telefone:** formato internacional sem espaços (**+1234567890**)
* **Dados limpos:** informações de contato precisas e atualizadas
* **Organização lógica:** priorize contatos secundários de forma adequada

<Note>
  Para solucionar problemas de gerenciamento de leads, consulte **Leads Troubleshooting**.
</Note>

<Note>
  Para instruções detalhadas de configuração, consulte **Managing Leads** e **Importing Leads**.
</Note>