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

# Pipeline e Board Kanban

> Use o board Kanban para visualizar e gerenciar suas oportunidades de venda

## O board Kanban

O board Kanban é a tela principal do CRM. Nele, você vê todas as oportunidades de venda organizadas em colunas, onde cada coluna representa um estágio do funil. Você pode arrastar cards entre as colunas para mover deals entre etapas.

Para acessar, clique em **Vendas > Pipeline** no menu lateral.

***

## O pipeline padrão

Quando o CRM é ativado na sua conta, um pipeline chamado **Vendas** é criado automaticamente com 6 estágios:

| Coluna      | Tipo    | Descrição                               |
| ----------- | ------- | --------------------------------------- |
| Lead        | Aberto  | Contato inicial, ainda sem qualificação |
| Qualificado | Aberto  | Interesse confirmado pelo contato       |
| Proposta    | Aberto  | Proposta comercial enviada              |
| Negociação  | Aberto  | Em negociação de valores ou condições   |
| Ganho       | Fechado | Venda concretizada                      |
| Perdido     | Fechado | Oportunidade não convertida             |

Cada coluna exibe no cabeçalho a quantidade de deals e o valor total acumulado. O topo do board mostra o total de deals abertos e a previsão de vendas (forecast) calculada com base no valor e probabilidade de cada deal.

<Note>
  Na versão atual, os estágios do pipeline são pré-configurados e não podem ser editados pela interface. Se precisar de estágios personalizados, entre em contato com o suporte.
</Note>

***

## Criar deals

Existem duas formas de criar um deal:

### Pelo board (manual)

<Steps>
  <Step title="Localize o botão de novo deal">
    No board Kanban, a primeira coluna aberta (Lead) exibe um botão **+ Novo deal** na parte inferior.
  </Step>

  <Step title="Digite o título">
    Um campo de texto aparece inline na coluna. Digite o título do deal (ex: "Maria Lima - Reserva Suíte") e pressione **Enter** para confirmar, ou **Esc** para cancelar.
  </Step>

  <Step title="Deal criado">
    O deal aparece como um card na coluna Lead. Clique nele para abrir o painel de detalhes e preencher mais informações.
  </Step>
</Steps>

### Automaticamente pela IA

Se você usa o Flow Builder, a IA pode criar deals automaticamente quando qualifica um lead durante a conversa. Nesse caso, o deal já vem vinculado à conversa e ao contato.

<Tip>
  Deals criados pela IA ficam automaticamente vinculados à conversa de origem. Isso permite que você navegue entre o deal e a conversa com um clique.
</Tip>

***

## Mover deals entre etapas (Drag-and-drop)

Para mover um deal para outro estágio, basta **arrastar o card** de uma coluna para outra. O reposicionamento é salvo automaticamente e atualizado em tempo real para toda a equipe.

### Arrastar para colunas abertas

Mover um deal entre colunas abertas (Lead, Qualificado, Proposta, Negociação) é um reposicionamento simples — o deal muda de estágio sem nenhuma ação adicional.

### Arrastar para Ganho ou Perdido

Quando você arrasta um deal para a coluna **Ganho** ou **Perdido**, o sistema abre automaticamente o modal de fechamento para que você confirme a ação. Isso garante que nenhum deal seja fechado por acidente.

<Warning>
  Arrastar para Ganho ou Perdido não move o deal diretamente. O sistema sempre pede confirmação via modal, e no caso de Perdido, pede o motivo da perda.
</Warning>

***

## Painel de detalhes do deal

Ao clicar em qualquer card no board, um painel desliza pela direita com os detalhes completos do deal.

### Informações editáveis

No painel de detalhes, você pode editar:

| Campo             | Descrição                                                                             |
| ----------------- | ------------------------------------------------------------------------------------- |
| **Título**        | Nome descritivo do deal                                                               |
| **Estágio**       | Etapa atual no pipeline                                                               |
| **Responsável**   | Agente responsável pelo deal                                                          |
| **Valor**         | Valor estimado da venda (em R\$)                                                      |
| **Probabilidade** | Chance de fechamento (0-100%). Se não definida, usa a probabilidade padrão do estágio |
| **Data prevista** | Data estimada para o fechamento                                                       |

Após editar os campos, clique em **Salvar** para confirmar as alterações.

### Abas do painel

O painel tem duas abas:

* **Detalhes** — campos editáveis e informações do deal
* **Tarefas** — lista de tarefas vinculadas a esse deal (veja mais em [Tarefas](/administradores/crm/tarefas))

### Link para a conversa

Se o deal está vinculado a uma conversa, o painel exibe um link clicável (ex: "Conversa: #1234") que leva direto para a conversa no WhatsApp.

***

## Converter um deal

A conversão é o momento em que você enriquece o deal com dados comerciais. Um deal pode funcionar sem conversão, mas converter ajuda a ter uma visão mais completa do funil.

<Steps>
  <Step title="Abra o painel de detalhes">
    Clique no card do deal no board.
  </Step>

  <Step title="Clique em Converter">
    No painel, clique no botão **Converter** (disponível apenas para deals abertos que ainda não foram convertidos).
  </Step>

  <Step title="Preencha os dados comerciais">
    O modal de conversão pede:

    * **Empresa** (obrigatório) — busque uma empresa existente ou crie uma nova inline
    * **Valor estimado** (opcional)
    * **Probabilidade** (opcional)
    * **Data prevista de fechamento** (opcional)
  </Step>

  <Step title="Confirme a conversão">
    Clique em **Converter** para confirmar. O deal ganha um indicador visual "Convertido" no painel.
  </Step>
</Steps>

<Note>
  A conversão não muda o estágio do deal. Você pode converter um deal em qualquer estágio. O que muda é que o deal passa a ter empresa vinculada e dados comerciais preenchidos.
</Note>

***

## Fechar um deal (Ganho ou Perdido)

Você pode fechar um deal de duas formas:

### Pelo painel de detalhes

<Steps>
  <Step title="Abra o painel de detalhes">
    Clique no card do deal no board.
  </Step>

  <Step title="Clique em Fechar negócio">
    No painel, clique no botão **Fechar negócio**.
  </Step>

  <Step title="Escolha o resultado">
    No modal de fechamento, selecione **Ganho** ou **Perdido**. Se escolher Perdido, preencha o motivo da perda.
  </Step>

  <Step title="Confirme">
    Clique para confirmar. O deal é movido automaticamente para a coluna correspondente (Ganho ou Perdido).
  </Step>
</Steps>

### Arrastando no board

Arraste o card diretamente para a coluna **Ganho** ou **Perdido**. O modal de fechamento abre automaticamente para você confirmar.

<Tip>
  As colunas Ganho e Perdido ficam colapsadas por padrão no board, mostrando apenas a contagem de deals. Clique no cabeçalho da coluna para expandir e ver os cards.
</Tip>

***

## Visão geral do board

O cabeçalho do board exibe informações consolidadas do pipeline:

* **Total de deals abertos** — quantos deals estão em estágios abertos
* **Forecast** — previsão de receita, calculada como a soma de `valor x probabilidade / 100` de todos os deals abertos

Cada coluna também exibe no cabeçalho:

* **Contagem** — número de deals naquele estágio
* **Valor total** — soma dos valores dos deals na coluna

***

## Exemplo prático

Imagine que você trabalha em um hotel e recebeu uma mensagem no WhatsApp de um casal interessado em reservar uma suíte para o Réveillon.

1. A IA qualifica o lead e cria automaticamente um deal "Carlos e Ana - Suíte Réveillon" na coluna Lead
2. Você abre o deal, vê que o contato tem interesse real, e arrasta para **Qualificado**
3. Envia uma proposta comercial e arrasta para **Proposta**
4. O casal pede desconto — você arrasta para **Negociação**, converte o deal com valor de R\$ 8.500 e empresa "Empresa do Carlos SA"
5. Acordo fechado! Você arrasta para **Ganho** (ou usa o botão **Fechado Ganho** direto na conversa)

Todo esse histórico fica registrado no deal, vinculado à conversa original.
