# Leads

## Finalidade Desta Página <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

A página de Leads serve como o **ponto de entrada do processo de vendas e qualificação** no solarVis.

Ela foi projetada para ajudar as equipes de vendas e projetos a:

* Coletar e organizar informações de potenciais clientes
* Qualificar oportunidades de vendas com base em localização, consumo de energia e tipo de sistema
* Acompanhar o progresso do lead através de estágios de vendas definidos
* Atribuir leads a usuários, equipes ou parceiros
* Identificar de onde os leads vêm (**módulo Lead Generator ou entrada manual**)
* Converter leads qualificados em projetos que continuam nos fluxos de trabalho de design e proposta

Ao gerenciar os leads de forma centralizada, as equipes mantêm visibilidade, consistência e rastreabilidade em todas as interações iniciais com o cliente.

## O Que Você Pode Fazer Aqui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

Na página de Leads, você pode:

* Visualizar todos os leads usando **visualizações em tabela, grade ou kanban**
* Criar novos leads manualmente ou analisar leads provenientes do Lead Generator
* Atribuir leads a usuários, equipes ou parceiros
* Pesquisar e filtrar leads usando múltiplos critérios
* Importar leads em massa ou exportar dados de leads para Excel
* Abrir registros detalhados de leads para revisão e adicionar atividades, notas e documentos
* Converter leads qualificados em projetos

## Como Funcionam os Leads <a href="#how-leads-work" id="how-leads-work"></a>

Os leads podem ser criados de várias formas dentro do solarVis:

* **Criação manual** por usuários a partir da página de Leads
* **Criação automática** via integração, chamada de **módulo Lead Generator do solarVis** incorporado em sites de empresas

Cada lead inclui informações essenciais como localização, tipo de instalação, tipo de conexão à rede, dados de contato, dados de consumo de energia e interesses opcionais de sistema.

### Identificação da Origem do Lead <a href="#lead-source-identification" id="lead-source-identification"></a>

Todo lead possui um valor de **Origem** que indica como ele foi criado.

Esta informação é visível na **coluna Origem**.

As origens de leads disponíveis incluem:

* **Company LeadGen**

  Leads são gerados automaticamente através do módulo Lead Generator do solarVis no site da empresa.
* **Manual (Entidades)**

  Leads são criados manualmente por usuários internos ou equipes diretamente na plataforma.

Essa distinção ajuda as equipes a entender a origem do lead, avaliar a qualidade do lead e analisar o desempenho em diferentes canais de aquisição.

## Estrutura da Página de Leads <a href="#leads-page-structure" id="leads-page-structure"></a>

Ela descreve como os leads são organizados, visualizados, filtrados e gerenciados ao longo de seu ciclo de vida, desde a captura inicial até a conversão em um projeto.

{% embed url="<https://app.arcade.software/share/7Qd4yyYmWUvzM10PWV4s?language=pt>" %}

### Visualizações de Leads <a href="#lead-views" id="lead-views"></a>

Os leads podem ser visualizados nesta página de três maneiras diferentes:

#### **Visualização em Tabela**

A **Visualização em Tabela** exibe todos os leads em formato de tabela.

Cada linha representa um único lead e inclui atributos-chave como:

* Nome do lead
* Informações de contato
* Responsável
* Usuário criador
* Entidade criadora
* Tipo de instalação
* Tipo de conexão à rede
* Localização
* Status do lead
* Origem
* Datas de criação e atualização

Os usuários podem personalizar as colunas visíveis usando o controle de seleção de colunas, tornando esta visualização ideal para relatórios e análises detalhadas.

#### Visualização em Grade

A **Visualização em Grade** apresenta cada lead como um cartão visual.

Cada cartão exibe:

* Imagem de satélite da localização do projeto
* Nome do lead
* Nome do contato
* Status de atribuição
* Localização
* Tipo de instalação
* Tipo de conexão à rede
* Origem do lead
* Datas de criação e atualização

Esta visualização é útil para examinar rapidamente os leads de forma visual e entender o contexto geográfico.

#### Visualização Kanban

A **Visualização Kanban** agrupa os leads pelo status atual em colunas verticais.

Os status típicos incluem:

* **Aberto:** Leads recém-criados ou não processados
* **Contactado:** Cliente foi contactado
* **Atribuído:** Lead foi atribuído a um usuário ou equipe responsável
* **Vistoria:** Avaliação em andamento
* **Convertido:** Lead foi convertido com sucesso em um projeto
* **Perdido:** Oportunidade não foi bem-sucedida
* **Fechado:** Lead encerrado sem conversão

Os leads podem ser movidos entre os estágios para refletir o progresso.

Esta visualização é especialmente útil para acompanhamento de vendas, previsões e gestão de carga de trabalho.

### Filtros e Pesquisa <a href="#filters-and-search" id="filters-and-search"></a>

O **painel de Filtros** permite que os usuários restrinjam os leads usando múltiplos critérios, incluindo:

* Localização
* Tipo de instalação
* Tipo de conexão à rede
* Status do lead
* Responsável
* Usuário criador
* Entidade criadora (empresa, parceiro, equipe)
* Origem do lead (Company LeadGen ou Manualmente)
* Convertido em projeto
* Arquivado
* Data de criação
* Data de atualização

A **barra de pesquisa** permite buscar por nome do lead, localização ou informações do cliente.

### Importação e Exportação <a href="#import-and-export" id="import-and-export"></a>

* Leads podem ser **importados em massa** usando a ação de importação
* Leads existentes podem ser **exportados para Excel** para relatórios, compartilhamento ou análise offline

### Criando um Novo Lead <a href="#creating-a-new-lead" id="creating-a-new-lead"></a>

Pode ser explicado como inserir e configurar todas as informações necessárias para criar um novo lead, garantindo a coleta precisa de dados para qualificação, análise e futura conversão em projeto.

#### Informações Gerais

Esta seção define os atributos principais do lead, incluindo:

* Tipo de lead (Residencial, Comercial, Industrial, Agrícola)
* Tipo de conexão à rede (On-Grid, Off-Grid, Zero Injection)
* Nome do lead
* Endereço e localização geográfica
* Atribuição a uma filial, equipe ou usuário

A localização pode ser inserida manualmente, selecionada no mapa ou detectada usando a localização atual.

#### Informações de Contato

Cada lead deve estar vinculado a um contato.

Você pode:

* Pesquisar e selecionar um contato existente por nome ou e-mail
* Adicionar um novo contato para vincular ao lead

Isso garante que as informações do cliente permaneçam consistentes entre leads e projetos.

#### Consumo de Energia

Esta seção define o perfil energético do cliente.

Você pode:

* Inserir o consumo médio mensal manualmente (kWh)
* Utilizar dados de consumo baseados em fatura

Os dados de consumo são usados posteriormente para dimensionamento do sistema, verificações de viabilidade e cálculos de proposta.

#### Sistemas Opcionais

Componentes opcionais do sistema podem ser habilitados, se aplicável:

* **Bateria**
* **Bomba de Calor**

Essas seleções afetam os cálculos futuros do projeto e as verificações de viabilidade.

## Detalhes do Lead Criado <a href="#created-lead-details" id="created-lead-details"></a>

Clique em um lead para editá-lo, convertê-lo ou analisá-lo.

{% embed url="<https://app.arcade.software/share/xG3Q7oJAYeogNR3glRn2?language=pt>" %}

### Aba de Visão Geral do Lead <a href="#lead-overview-tab" id="lead-overview-tab"></a>

A aba Visão Geral fornece um resumo completo do lead, incluindo:

* Imagem de satélite da localização
* Endereço completo e coordenadas
* Tipo de instalação
* Tipo de conexão à rede
* Indicadores de interesse em sistema (painel, bateria, bomba de calor)
* Informações de contato vinculadas
* Detalhes do criador
* Data de criação

Um link para o **Google Maps** está disponível para navegação direta.

#### **Projetos Associados**

Esta seção exibe os projetos criados a partir do lead.

As informações incluem:

* Potência do projeto
* Capacidade da bateria
* Preço total com e sem IVA
* Preço por kWp com e sem IVA

Isso ajuda a comparar os resultados dos projetos após a conversão.

{% hint style="info" %}
Vários projetos podem ser convertidos a partir de um único lead. Após a conversão, o sistema navega automaticamente o usuário para a página do projeto. O projeto é inicialmente criado com o nome do lead, mas o nome pode ser alterado posteriormente.
{% endhint %}

#### Painel de Consumo

Exibe:

* Consumo médio mensal
* Perfil de consumo
* Um gráfico visual de consumo para análise rápida

#### Painel de Notas

Permite que usuários internos adicionem notas relacionadas ao lead.

As notas suportam:

* Acompanhamento de vendas
* Comunicação interna
* Rastreio do histórico de comunicação

#### Ações do Lead

A partir da visão geral do lead, os usuários podem:

* Converter o lead em um projeto
* Editar informações do lead
* Usar o menu de três pontos para;
  * Atribuir ou reatribuir o lead
  * Atualizar o status do lead
  * Arquivar o lead

### Aba de Atividades do Lead <a href="#lead-activities-tab" id="lead-activities-tab"></a>

A aba **Atividades** fornece uma linha do tempo completa e cronológica de tudo o que aconteceu com um lead desde sua criação.

Cada entrada de atividade registra:

* O tipo de ação realizada
* O usuário responsável pela ação (ou sistema, quando aplicável)
* Um breve resumo descritivo da ação
* A data e hora exatas em que a ação ocorreu

As atividades são exibidas em ordem cronológica, permitindo que os usuários acompanhem facilmente a evolução do lead ao longo do tempo.

Atividades típicas registradas nesta aba incluem:

* Criação do lead
* Conversão do lead em projeto
* Mudanças de status do lead
* Atribuição ou reatribuição a um usuário, equipe ou filial
* Atualizações acionadas pelo sistema relacionadas ao ciclo de vida do lead

As equipes de vendas e projetos usam a aba Atividades para entender rapidamente todo o histórico de um lead e obter contexto antes de contatar o cliente ou mover o lead para o próximo estágio.

Esta aba garante transparência, responsabilidade e rastreabilidade em todo o processo de vendas.

### Aba de Notas do Lead <a href="#lead-notes-tab" id="lead-notes-tab"></a>

A aba **Notas** é usada para comunicação interna e colaboração relacionada a um lead.

As notas são **apenas internas** e nunca são visíveis para clientes ou partes externas.

Cada nota pode incluir:

* Conteúdo em texto livre para explicações, comentários ou lembretes
* Um único anexo de arquivo, se necessário

{% hint style="info" %}
Se você adicionar um arquivo aqui, ele aparecerá automaticamente na aba Documentos.
{% endhint %}

As notas são exibidas em ordem cronológica, criando uma narrativa contínua das discussões e decisões internas.

Casos de uso comuns para notas incluem:

* Resumos de ligações e resultados de reuniões
* Lembretes de acompanhamento e próximos passos
* Preferências do cliente ou considerações especiais
* Alinhamento interno e documentação de decisões

**Anexos de Arquivos em Notas**

Ao anexar arquivos às notas, aplicam-se as seguintes regras:

* Apenas **um arquivo** pode ser anexado por nota
* O tamanho máximo do arquivo é **10 MB**

Isso mantém as notas leves, mas ainda permite que materiais de apoio importantes sejam capturados junto às discussões internas.

A aba Notas ajuda as equipes a manterem-se alinhadas e preserva o contexto diretamente no registro do lead.

### Aba de Documentos do Lead <a href="#lead-documents-tab" id="lead-documents-tab"></a>

A aba **Documentos** é o local central para gerenciar todos os arquivos associados a um lead.

Ela garante que os documentos específicos do lead estejam organizados, acessíveis e preservados durante todo o ciclo de vendas.

Cada entrada de documento inclui:

* Nome do arquivo
* Data de upload
* Usuário que fez o upload do documento
* Ação de download
* Ação de exclusão

{% hint style="info" %}
Os documentos são armazenados independentemente das notas, tornando-os mais fáceis de encontrar e gerenciar à medida que o lead avança.
{% endhint %}

A aba Documentos suporta o upload e gerenciamento de arquivos como:

* Documentos fornecidos pelo cliente
* Faturas de consumo ou anexos técnicos
* Quaisquer arquivos de apoio necessários durante a qualificação

Ao centralizar a gestão de documentos no nível do lead, as equipes mantêm um histórico de arquivos consistente e rastreável em toda a jornada do cliente.

### Aba de Propostas do Lead <a href="#lead-proposals-tab" id="lead-proposals-tab"></a>

A aba **Propostas** exibe todas as propostas que foram criadas e enviadas para o lead **após sua conversão em projeto.**

Ela permite que as equipes de vendas acompanhem o envio de propostas, o engajamento do cliente, preços e status de aceitação diretamente no registro do lead.

#### Informações da Lista de Propostas

Para cada proposta, as seguintes informações são exibidas:

* Link da Proposta
* Cliente (o cliente associado à proposta)
* Nome do Design (o design do sistema usado para gerar a proposta)
* Data de Envio
* Enviado Via
* Status da Proposta
* Valor da Proposta (Com IVA)
* Valor da Proposta (Sem IVA)
* Tipo de Conexão à Rede
* Status Ativo / Inativo
* Visualizar Detalhes;
  * Data de visualização
  * Tempo de exibição (quanto tempo a proposta foi visualizada)
  * Canal de visualização (e-mail, SMS ou link)

{% hint style="info" %}
Os dados da proposta serão exibidos assim que um lead for convertido em projeto.
{% endhint %}

### Convertendo um Lead em Projeto <a href="#converting-a-lead-into-a-project" id="converting-a-lead-into-a-project"></a>

Ao converter um lead:

1. Um modal de confirmação é exibido
2. O modal resume os principais detalhes do projeto, como:
   * Tipo de instalação
   * Tipo de conexão à rede
   * Endereço
   * Cliente
   * Equipe ou usuário atribuído
3. Após a confirmação, um novo projeto é criado usando os dados do lead

O projeto então segue pelo **fluxo de trabalho de design e proposta**.

{% hint style="info" %}
Ao converter um lead em projeto, o sistema exibe um erro se o lead não possuir localização, pois o solarVis seleciona as regulamentações com base na localização.
{% endhint %}

### Editando um Lead <a href="#editing-a-lead" id="editing-a-lead"></a>

A ação **Editar Lead** permite que os usuários atualizem as informações do lead após a criação.

Ao clicar em **Editar**, o sistema abre a página **Editar Lead**, onde você pode modificar as mesmas seções disponíveis na criação de um novo lead.

***

## Páginas Relacionadas <a href="#related-articles" id="related-articles"></a>

* [Página de Contatos](/documentation/pt/crm-and-project-management/contacts.md)
* [Página de Projetos](/documentation/pt/crm-and-project-management/projects.md)

Se você encontrar algum problema nesta seção, [sinta-se à vontade para nos contatar.](https://www.solarvis.co/en/company/contact)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solarvis.co/documentation/pt/crm-and-project-management/leads.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
