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

# Visão Geral de Leads

> Gerencie seus contatos de campanha 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 seu assistente de IA pode usar durante as conversas.

## O que são Leads?

Leads representam as pessoas ou empresas que você deseja contatar através de suas campanhas. O sistema de leads suporta:

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

    O número de telefone principal e informações de contato
  </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 com IA

    Nomes, preferências, histórico ou quaisquer dados que seu assistente precise
  </Card>

  <Card title="Rastreamento de Status" icon="chart-line">
    **Monitoramento de progresso** através do ciclo de vida da campanha

    Acompanhe tentativas de chamada, conclusões e status de nova tentativa
  </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 ligar** - Lead está na fila para primeira tentativa de contato
  </Accordion>

  <Accordion title="Agendado" icon="calendar">
    **Na fila para nova tentativa** - Agendado para próxima tentativa de chamada baseado nas configurações da campanha
  </Accordion>

  <Accordion title="Processando" icon="phone">
    **Sendo chamado atualmente** - Chamada em andamento
  </Accordion>

  <Accordion title="Reagendado" icon="clock">
    **Aguardando nova tentativa** - Será chamado novamente após intervalo de nova tentativa
  </Accordion>

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

  <Accordion title="Concluído" icon="check">
    **Contatado com sucesso** - Chamada concluída ou objetivo alcançado
  </Accordion>
</AccordionGroup>

## Contatos Principais vs Secundários

### Contatos Principais

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

### Contatos Secundários

* **Números de telefone adicionais** para a mesma pessoa/empresa
* **Chamados se o principal não atender** (baseado nas configurações de nova tentativa da campanha)
* **Rastreamento de status independente** do contato principal
* **Podem ter variáveis únicas** diferentes do principal

<Tip>
  **Exemplo de caso de uso:** Um lead empresarial pode ter o número do escritório principal como contato principal, com a linha direta do tomador de decisão e celular como contatos secundários.
</Tip>

## Sistema de Variáveis

Variáveis personalizam conversas de IA 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 personalizadas por lead.

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

## Recursos Principais

### Gerenciamento de Leads

* **Criação manual** ou **importação CSV/Excel** com validação
* **Rastreamento de status** através do ciclo de vida da campanha
* **Capacidades de exportação** com opções de filtragem

### Integração com Campanhas

* Atribuição de **campanha única** por lead
* **Atualizações automáticas de status** baseadas em resultados de chamadas
* **Controle manual de status** para gerenciamento de campanhas

### Melhores Práticas

* **Formato de telefone:** Formato internacional sem espaços (+1234567890)
* **Dados limpos:** Informações de contato precisas e atuais
* **Organização lógica:** Priorize contatos secundários adequadamente

<Note>
  Para solução de problemas de gerenciamento de leads, consulte [Solução de Problemas de Leads](/troubleshooting/leads).
</Note>

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