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

# CRM na tela de conversa

> Veja como o CRM aparece durante o atendimento e feche deals sem sair da conversa

## CRM integrado ao atendimento

Se a sua conta tem o módulo CRM ativado, você vai notar algumas novidades na tela de conversa. O objetivo é simples: permitir que você gerencie oportunidades de venda sem precisar sair da conversa que está atendendo.

<Note>
  As funcionalidades de CRM na conversa só aparecem quando o módulo **CRM** está ativo na sua conta. Se você não vê nada do que está descrito aqui, fale com seu administrador.
</Note>

***

## Chip do deal no header da conversa

Quando uma conversa tem um deal (negócio) vinculado e aberto, um **chip** aparece no header da conversa, ao lado das informações do contato.

O chip mostra:

* O **estágio atual** do deal (ex: "Proposta")
* O **valor** do deal, se preenchido (ex: "R\$ 8.500")

Ao clicar no chip, o painel de detalhes do deal abre pela lateral direita, onde você pode ver e editar todas as informações sem sair da conversa.

<Tip>
  O chip atualiza em tempo real. Se outro agente mover o deal para outro estágio pelo board Kanban, você vê a mudança refletida no header imediatamente.
</Tip>

***

## Widget Kanban no painel do contato

No painel lateral direito da conversa (onde ficam as informações do contato), existe uma seção chamada **Kanban** que mostra o contexto do deal vinculado à conversa.

### Quando a conversa tem um deal vinculado

O widget exibe:

* **Funil** — o nome do pipeline (ex: "Vendas")
* **Etapa atual** — em que estágio o deal está
* **Última atualização** — quando o deal foi atualizado pela última vez

Abaixo dessas informações, o widget tem três abas:

| Aba          | O que faz                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| **Mover**    | Lista os estágios abertos do pipeline. Clique em um estágio para mover o deal sem precisar ir até o board |
| **Agentes**  | Permite trocar o responsável pelo deal                                                                    |
| **Detalhes** | Abre o painel completo do deal pela lateral                                                               |

### Quando a conversa não tem deal

Se a conversa não tem nenhum deal vinculado, o widget exibe um botão **Marcar como Lead**. Ao clicar, um deal é criado automaticamente no primeiro estágio do pipeline (Lead), vinculado à conversa e com você como responsável.

<Tip>
  Use o botão "Marcar como Lead" quando perceber que uma conversa tem potencial comercial. É a forma mais rápida de começar a rastrear uma oportunidade.
</Tip>

***

## Fechado Ganho / Fechado Perdido

Essa é uma das integrações mais práticas do CRM. Quando uma conversa tem um deal aberto vinculado, o **dropdown do botão Resolver** ganha duas novas opções no topo:

* **Fechado Ganho** — resolve a conversa e fecha o deal como ganho, tudo de uma vez
* **Fechado Perdido** — resolve a conversa e fecha o deal como perdido (pede o motivo)

### Quando essas opções aparecem?

Duas condições precisam ser verdadeiras ao mesmo tempo:

1. O módulo **CRM** está ativo na conta
2. A conversa tem um **deal aberto** vinculado

Se a conversa não tem deal, ou se o deal já foi fechado (ganho ou perdido), as opções não aparecem e o dropdown continua igual ao normal.

### Como usar

<Steps>
  <Step title="Abra a conversa">
    Acesse a conversa que você quer resolver.
  </Step>

  <Step title="Clique na seta ao lado de Resolver">
    No header da conversa, clique na seta (chevron) ao lado do botão **Resolver** para abrir o dropdown.
  </Step>

  <Step title="Escolha a opção CRM">
    Selecione **Fechado Ganho** se a venda foi fechada, ou **Fechado Perdido** se a oportunidade não se concretizou.
  </Step>

  <Step title="Confirme (se Perdido)">
    Se escolheu Perdido, um mini-modal aparece pedindo o motivo da perda. Preencha e confirme.
  </Step>
</Steps>

<Warning>
  Ao usar "Fechado Ganho" ou "Fechado Perdido", ambas as ações acontecem juntas: a conversa é resolvida E o deal é fechado. Não dá para desfazer automaticamente — se errar, você precisará reabrir a conversa e criar um novo deal.
</Warning>

### O que acontece por baixo

Quando você clica em uma dessas opções:

1. A conversa é resolvida normalmente (mesmo comportamento do botão Resolver padrão)
2. O deal vinculado é fechado com o resultado escolhido (Ganho ou Perdido)
3. O deal é movido para a coluna correspondente no board Kanban
4. Se Perdido, o motivo é registrado no deal para consulta futura

***

## Exemplo prático

Você está atendendo a Ana no WhatsApp. Ela veio pelo anúncio do pacote Réveillon e você já criou um deal para ela.

1. No header da conversa, você vê o chip **"Negociação - R\$ 12.000"** — a Ana está na fase final
2. No painel do contato, o widget Kanban mostra o deal com a opção de mover para outro estágio
3. Ana confirma a reserva pela conversa. Você clica na seta ao lado de **Resolver** e seleciona **Fechado Ganho**
4. Pronto! A conversa é resolvida e o deal vai automaticamente para a coluna Ganho no board

Todo o fluxo acontece sem você precisar sair da tela de conversa.

***

## Resumo rápido

| Elemento             | Onde fica                       | O que faz                                                           |
| -------------------- | ------------------------------- | ------------------------------------------------------------------- |
| **Chip do deal**     | Header da conversa              | Mostra estágio e valor; clique para abrir detalhes                  |
| **Widget Kanban**    | Painel do contato (lateral)     | Mostra contexto do deal; permite mover estágio e trocar responsável |
| **Marcar como Lead** | Widget Kanban (quando sem deal) | Cria deal vinculado à conversa                                      |
| **Fechado Ganho**    | Dropdown do botão Resolver      | Resolve conversa e fecha deal como ganho                            |
| **Fechado Perdido**  | Dropdown do botão Resolver      | Resolve conversa e fecha deal como perdido                          |