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

# Gerenciando Leads

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

Aprenda a **criar**, **editar** e **gerenciar leads** de forma eficaz para suas campanhas, com a configuração correta de **variáveis** e o 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 campanha à qual este lead pertence
3. **Status:** definido automaticamente como **"Created"** para novos leads

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

### **Configuração de Variáveis**

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

Ao selecionar uma campanha, o lead herda automaticamente as variáveis da configuração do assistente:

* **Valores pré-preenchidos:** as variáveis padrão do assistente aparecem no formulário
* **Personalização:** modifique os valores específicos para este lead
* **Campos obrigatórios:** algumas variáveis podem ser necessárias para o funcionamento da campanha

**Variáveis Personalizadas**

Adicione informações personalizadas para o uso do seu assistente de IA:

**Tipos comuns de variáveis:**

* **customer\_name:** nome da pessoa para saudações personalizadas
* **company:** nome da empresa para conversas B2B
* **last\_interaction:** contexto da conversa anterior
* **preferences:** preferências ou necessidades 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": "Requested demo of premium features",
  "preferred_contact_time": "Afternoon EST",
  "industry": "Software Development"
}
```

### **Contatos Secundários**

Adicione **números de telefone adicionais** para o mesmo lead quando houver várias formas de contato.

### **Quando Usar Contatos Secundários**

* **Tomadores de decisão:** várias pessoas envolvidas no processo de decisão
* **Números de backup:** celular, escritório ou residencial da mesma pessoa
* **Contatos por departamento:** diferentes setores dentro da mesma empresa
* **Contatos por horário:** números diferentes para diferentes períodos do dia

### **Configuração de Contatos Secundários**

* **Adicionar Contato Secundário:** clique em **"Add Secondary Contact"** no formulário
* **Número de telefone:** insira o número de telefone adicional
* **Variáveis:** defina variáveis específicas para este contato (opcional)
* **Ordem:** os contatos são chamados na ordem em que forem adicionados

<Tip>
  A **ordem dos contatos** é importante: a campanha tentará os contatos **em sequência**. Coloque **primeiro o que tem mais chances de atender**.
</Tip>

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

Cada contato secundário pode ter **variáveis exclusivas**:

* **Pessoa diferente:** use variáveis diferentes de nome e função
* **Mesma pessoa:** mantenha as mesmas informações pessoais, mas com preferências de contato diferentes
* **Departamento específico:** personalize conforme as necessidades de cada departamento

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

```json theme={null}
// Primary: CEO
{
  "contact_name": "John Smith",
  "role": "CEO", 
  "decision_authority": "Final approval"
}

// Secondary: CTO  
{
  "contact_name": "Jane Doe",
  "role": "CTO",
  "decision_authority": "Technical decisions"
}
```

## 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 outra campanha, se necessário
* **Status:** altere manualmente o status para controle da campanha

**Gerenciamento de Variáveis**

* **Atualizar valores:** modifique os valores das variáveis existentes
* **Adicionar variáveis:** inclua novas informações para melhorar o contexto da IA
* **Remover variáveis:** exclua dados desatualizados ou irrelevantes

<Warning>
  **Campaign compatibility:** When changing campaigns, ensure variables match the new assistant's configuration.
</Warning>

### **Gerenciamento de Contatos Secundários**

* **Adicionar contatos:** inclua números de telefone adicionais
* **Remover contatos:** exclua 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 de cada contato

### **Gerenciamento de Status de Leads**

### **Entendendo as Mudanças de Status**

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

* **Created → Processing:** quando a campanha inicia a chamada
* **Processing → Completed:** quando a chamada é bem-sucedida ou o objetivo é alcançado
* **Processing → Rescheduled:** quando a chamada precisa ser repetida
* **Rescheduled → Max Retries:** quando o limite de tentativas é atingido

### **Controle Manual de Status**

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

### **Reiniciar para Nova Chamada**

Defina como **"Created"** para reiniciar o lead e colocá-lo novamente na fila de chamadas.

* **Caso de uso:** o lead solicitou um retorno em horário específico
* **Efeito:** o lead retorna à fila da campanha
* **Considerações:** respeita os limites de repetição da campanha

### **Marcar como Concluído**

Defina como **"Completed"** para impedir que a campanha volte a chamar o lead.

* **Caso de uso:** o objetivo foi alcançado por outros canais
* **Efeito:** o lead é excluído das futuras chamadas da campanha
* **Considerações:** não pode ser redefinido automaticamente pela campanha

### **Outras Mudanças de Status**

* **"Scheduled":** coloca o lead na fila para a próxima tentativa
* **"Max Retries":** marca manualmente como esgotado
* **"Rescheduled":** redefine o temporizador de repetição

<Tip>
  **Estratégia de status:** use alterações manuais de status com moderação.\
  Deixe que a **automação da campanha** gerencie a maioria das atualizações para garantir um comportamento consistente.
</Tip>

## **Operações em Lote**

### **Exclusão em Lote**

Selecione vários leads e exclua-os:

* **Filtrar leads:** use os filtros da tabela para selecionar leads específicos
* **Selecionar leads:** marque as caixas dos leads que deseja excluir
* **Excluir em lote:** escolha a ação de exclusão no menu de ações em massa
* **Confirmar:** revise as alterações antes de aplicar

### **Exportação em Lote**

Exporte os dados filtrados dos leads para processamento externo:

* **Aplicar filtros:** filtre por campanha, status ou intervalo de datas
* **Selecionar colunas:** escolha quais dados exportar
* **Incluir secundários:** opção para incluir contatos secundários
* **Download:** formato **CSV** compatível com planilhas

### **Organização de Leads**

Use **filtros de tabela**, **ordenação** e **pesquisa** para organizar leads por campanha, status, intervalo de datas ou conteúdo das variáveis.

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

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

### **Boas Práticas**

### **Pontos Principais**

* **Formato de telefone:** formato internacional sem espaços (**+1234567890**)
* **Variáveis:** use nomes consistentes e informações relevantes
* **Contatos secundários:** organize por prioridade e evite duplicações
* **Privacidade:** siga os requisitos de proteção de dados

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

<Note>
  Para obter informações sobre **importação de leads em lote**, consulte **Importing Leads**.
</Note>