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

# Gerenciando Leads

> Crie, edite e organize leads com variáveis personalizadas e contatos secundários

Aprenda como criar, editar e gerenciar leads efetivamente para suas campanhas com configuração adequada de variáveis e gerenciamento de contatos secundários.

## Criando um Novo Lead

### Informações Básicas

1. **Número de Telefone:** Insira o número de contato principal no formato internacional
2. **Atribuição de Campanha:** Selecione a qual campanha este lead pertence
3. **Status:** Automaticamente definido como "Criado" para novos leads

<Note>
  **Formato de número de telefone:** Use o formato internacional sem espaços ou parênteses (+1234567890) para importações de automação e uploads de arquivos.
</Note>

### Configuração de Variáveis

#### Variáveis Padrão do Assistente

Quando você seleciona uma campanha, o lead automaticamente herda variáveis da [configuração do assistente](/ai-assistants/settings/prompt-and-tools#call-variables):

* **Valores pré-preenchidos:** Variáveis padrão do assistente aparecem no formulário
* **Personalização:** Modifique valores específicos para este lead
* **Campos obrigatórios:** Algumas variáveis podem ser obrigatórias para funcionalidade da campanha

#### Variáveis Personalizadas

Adicione informações personalizadas para seu assistente de IA usar:

**Tipos comuns de variáveis:**

* **customer\_name:** Nome da pessoa para saudações personalizadas
* **company:** Nome da empresa para conversas B2B
* **last\_interaction:** Contexto de conversa anterior
* **preferences:** Preferências ou requisitos do cliente
* **budget\_range:** Informações financeiras para chamadas de vendas

**Exemplo de formato de variável:**

```json theme={null}
{
  "customer_name": "Sarah Johnson",
  "company": "TechStart Solutions", 
  "last_interaction": "Solicitou demonstração dos recursos premium",
  "preferred_contact_time": "Tarde EST",
  "industry": "Desenvolvimento de Software"
}
```

### Contatos Secundários

Adicione números de telefone adicionais para o mesmo lead quando você tiver múltiplas formas de alcançá-los.

#### Quando Usar Contatos Secundários

* **Tomadores de decisão:** Múltiplas pessoas envolvidas na decisão
* **Números de backup:** Números de celular, escritório, residencial para a mesma pessoa
* **Contatos de departamento:** Diferentes departamentos na mesma empresa
* **Contatos baseados em horário:** Números diferentes para horários diferentes

#### Configuração de Contato Secundário

1. **Adicionar Contato Secundário:** Clique em "Adicionar Contato Secundário" no formulário
2. **Número de Telefone:** Insira número de telefone adicional
3. **Variáveis:** Defina variáveis específicas para este contato (opcional)
4. **Ordem:** Contatos são tentados na ordem em que você os adiciona

<Tip>
  **A ordem dos contatos importa:** A campanha tentará os contatos em sequência. Coloque o mais provável de atender primeiro.
</Tip>

#### Variáveis de Contato Secundário

Cada contato secundário pode ter variáveis únicas:

* **Pessoa diferente:** Use variáveis de nome e função diferentes
* **Mesma pessoa:** Use mesmas informações pessoais mas preferências de contato diferentes
* **Específico do departamento:** Personalize para necessidades específicas do departamento

**Exemplo - Múltiplos tomadores de decisão:**

```json theme={null}
// Principal: CEO
{
  "contact_name": "John Smith",
  "role": "CEO", 
  "decision_authority": "Aprovação final"
}

// Secundário: CTO  
{
  "contact_name": "Jane Doe",
  "role": "CTO",
  "decision_authority": "Decisões técnicas"
}
```

## Editando Leads Existentes

### Modificando Informações do Lead

* **Número de telefone:** Atualize se as informações de contato mudarem
* **Campanha:** Mova o lead para uma campanha diferente se necessário
* **Status:** Altere manualmente o status para controle da campanha

### Gerenciamento de Variáveis

* **Atualizar valores:** Modifique valores de variáveis existentes
* **Adicionar variáveis:** Inclua novas informações para melhor contexto de IA
* **Remover variáveis:** Delete dados desatualizados ou irrelevantes

<Warning>
  **Compatibilidade de campanha:** Ao mudar de campanha, garanta que as variáveis correspondam à configuração do novo assistente.
</Warning>

### Gerenciamento de Contatos Secundários

* **Adicionar contatos:** Inclua números de telefone adicionais
* **Remover contatos:** Delete números inválidos ou desnecessários
* **Reordenar contatos:** Altere a prioridade da sequência de chamadas
* **Atualizar variáveis:** Modifique informações específicas do contato

## Gerenciamento de Status de Leads

### Entendendo Mudanças de Status

O status do lead é atualizado automaticamente com base na atividade da campanha:

* **Criado → Processando:** Quando a campanha começa a ligar
* **Processando → Concluído:** Quando a chamada tem sucesso ou objetivo é alcançado
* **Processando → Reagendado:** Quando a chamada precisa de nova tentativa
* **Reagendado → Máx. Tentativas:** Quando o limite de tentativas é atingido

### Controle Manual de Status

Você pode alterar manualmente o status do lead quando necessário:

#### Redefinir para Nova Chamada

**Definir como "Criado":** Redefine o lead para ser chamado novamente

* **Caso de uso:** Lead solicitou retorno em horário específico
* **Efeito:** Lead retorna à fila da campanha
* **Considerações:** Respeita limites de nova tentativa da campanha

#### Marcar como Concluído

**Definir como "Concluído":** Impede a campanha de ligar para este lead

* **Caso de uso:** Objetivo alcançado através de outros canais
* **Efeito:** Lead excluído de futuras chamadas da campanha
* **Considerações:** Não pode ser redefinido automaticamente pela campanha

#### Outras Mudanças de Status

* **"Agendado":** Colocar na fila para próxima tentativa
* **"Máx. Tentativas":** Marcar manualmente como esgotado
* **"Reagendado":** Redefinir temporizador de nova tentativa

<Tip>
  **Estratégia de status:** Use mudanças manuais de status com moderação. Deixe a automação da campanha lidar com a maioria das atualizações de status para comportamento consistente.
</Tip>

## Operações em Lote

### Exclusão em Lote

Selecione múltiplos leads e exclua-os:

1. **Filtrar leads:** Use filtros de tabela para selecionar leads específicos
2. **Selecionar leads:** Marque as caixas dos leads a excluir
3. **Exclusão em lote:** Escolha ação de exclusão no menu de ações em lote
4. **Confirmar:** Revise as alterações antes de aplicar

### Exportação em Lote

Exporte dados de leads filtrados para processamento externo:

* **Aplicar filtros:** Filtre por campanha, status, intervalo de datas
* **Selecionar colunas:** Escolha quais dados exportar
* **Incluir secundários:** Opção de incluir contatos secundários
* **Baixar:** Formato CSV para compatibilidade com planilhas

## Organização de Leads

Use filtros de tabela, classificação e busca para organizar leads por campanha, status, intervalo de datas ou conteúdo de variável.

## Integração com Campanhas

* Atribuição de **campanha única** por lead
* **Herança de variáveis** da configuração do assistente
* **Coordenação automática** com cronograma da campanha e lógica de nova tentativa

## Melhores Práticas

### Pontos-Chave

* **Formato de telefone:** Formato internacional sem espaços (+1234567890)
* **Variáveis:** Use nomenclatura consistente e informações relevantes
* **Contatos secundários:** Ordene por prioridade, evite duplicados
* **Privacidade:** Siga os requisitos de proteção de dados

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

<Note>
  Para informações sobre importação de leads em lote, consulte [Importando Leads](/leads/importing-leads).
</Note>