> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/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

Leads são os contatos que suas campanhas irão ligar. Cada lead pode ter **múltiplos números de telefone** (contatos secundários) e **variáveis personalizadas** que o assistente de IA utiliza durante as conversas.

## O que são Leads?

Leads representam pessoas ou empresas que você deseja contatar por meio das campanhas. O sistema de leads oferece suporte a:

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

    Número de telefone principal e informações básicas
  </Card>

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

    Contatos alternativos, decisores ou números de backup
  </Card>

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

    Nome, preferências, histórico ou qualquer dado necessário
  </Card>

  <Card title="Controle de Status" icon="chart-line">
    **Acompanhamento de progresso**

    Monitoramento de tentativas, chamadas concluídas e retries
  </Card>
</CardGroup>

## Sistema de Status do Lead

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

<AccordionGroup>
  <Accordion title="Created" icon="plus">
    **Pronto para ligar** — Lead na fila para a primeira tentativa de contato
  </Accordion>

  <Accordion title="Scheduled" icon="calendar">
    **Agendado para retry** — Nova tentativa programada conforme as regras da campanha
  </Accordion>

  <Accordion title="Processing" icon="phone">
    **Em chamada** — Ligação em andamento
  </Accordion>

  <Accordion title="Rescheduled" icon="clock">
    **Aguardando nova tentativa** — Será chamado após o intervalo configurado
  </Accordion>

  <Accordion title="Max Retries" icon="ban">
    **Limite de tentativas atingido** — Número máximo de chamadas excedido
  </Accordion>

  <Accordion title="Completed" icon="check">
    **Concluído com sucesso** — Chamada finalizada ou objetivo atingido
  </Accordion>
</AccordionGroup>

## Contato Principal vs. Contatos Secundários

### Contato Principal

* **Registro principal** do lead com todas as informações
* **Primeiro a ser chamado** na sequência da campanha
* **Herda variáveis da campanha** configuradas no assistente
* **Controla o status geral** do lead

### Contatos Secundários

* **Números adicionais** da mesma pessoa ou empresa
* **Chamados caso o principal não atenda** (conforme regras de retry)
* **Status independente** do contato principal
* **Podem ter variáveis próprias**, diferentes do principal

<Tip>
  **Exemplo de uso:** Uma empresa pode ter o telefone geral como contato principal e o telefone direto do decisor e o celular como contatos secundários.
</Tip>

## Sistema de Variáveis

Variáveis personalizam as conversas com informações específicas do lead. Elas são herdadas da [configuração do assistente](/ai-assistants/settings/prompt-and-tools#call-variables) e podem ser ajustadas por lead.

**Uso nas conversas:** O assistente utiliza variáveis como `{customer_name}` e `{company}` para respostas personalizadas.

## Funcionalidades Principais

### Gestão de Leads

* **Criação manual** ou **importação via CSV/Excel** com validação
* **Acompanhamento de status** ao longo da campanha
* **Exportação de dados** com filtros

### Integração com Campanhas

* **Vinculação a uma única campanha**
* **Atualização automática de status** conforme o resultado das chamadas
* **Controle manual de status** para gestão operacional

### Boas Práticas

* **Formato do telefone:** Internacional sem espaços (+1234567890)
* **Dados limpos:** Informações atualizadas e corretas
* **Organização lógica:** Priorize corretamente os contatos secundários

<Note>
  Para solucionar problemas comuns, veja [Solução de Problemas de Leads](/troubleshooting/leads).
</Note>

<Note>
  Para instruções detalhadas, consulte [Gerenciamento de Leads](/leads/managing-leads) e [Importação de Leads](/leads/importing-leads).
</Note>