> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/kanban.md).

# Kanban

### Finalidade

O **Kanban** é o quadro visual de funil comercial/operacional: colunas (etapas), cards ligados a **contatos**, valores, probabilidade, status do funil e automações.

Não confundir com a escolha rápida de kanban **dentro do Atendimento** (painel do contato) — aqui você gerencia o quadro completo.

**Caminho:** menu lateral → **Kanban**

Requisito: módulo **Plus**. O usuário só vê colunas às quais tem acesso (próprias ou compartilhadas).

\[\[FOTO]]

***

### O que você vê na tela

Cabeçalho **Painel Ativo** com:

| Elemento                           | Função                                             |
| ---------------------------------- | -------------------------------------------------- |
| Alternar **Kanban / Estatísticas** | Quadro de colunas ou dashboard de indicadores      |
| Selecionar usuário                 | Só **admin**: visualizar o kanban de outro usuário |
| Período (data)                     | Filtra cards pela data de entrada no kanban        |
| Total geral                        | Soma dos valores dos cards visíveis                |
| Adicionar nova coluna              | Cria etapa no funil (modo Kanban)                  |

\[\[FOTO]]

***

### Modo Kanban (quadro)

#### Colunas

Cada coluna mostra:

* Nome e **quantidade** de cards
* **Valor total** da coluna (e valor **ponderado** pela probabilidade)
* Ações (conforme permissão):

| Ação             | Quem            | Função                                       |
| ---------------- | --------------- | -------------------------------------------- |
| Editar / Excluir | Dono da coluna  | Altera nome, cor, posição ou remove a coluna |
| Adicionar item   | Quem tem acesso | Cria card na coluna                          |
| Compartilhar     | Quem tem acesso | Define usuários com acesso à coluna          |
| Automações       | Quem tem acesso | Regras automáticas da coluna                 |

\[\[FOTO]]

#### Criar ou editar coluna

1. Clique em **Adicionar nova coluna** (ou editar no cabeçalho da coluna).
2. Preencha **nome**, **cor** e **posição** (antes/depois de outra coluna, ou posição numérica na edição).
3. Salve.

\[\[FOTO]]

#### Cards

Arraste o card entre colunas para mover (drag and drop), ou use o menu **Mover**.

No card aparecem tipicamente: contato, valor, probabilidade, status do funil (Aberto / Ganho / Perdido), responsável, data de entrada, notas e atalho de ligação (quando aplicável).

**Menu do card**

| Ação                                                                     | Função                                      |
| ------------------------------------------------------------------------ | ------------------------------------------- |
| Iniciar ticket                                                           | Abre/atende a conversa do contato           |
| Ligar                                                                    | Dispara chamada (quando disponível)         |
| Editar valor / descrição / probabilidade / responsável / status do funil | Ajustes rápidos                             |
| Editar card                                                              | Modal completo                              |
| Mover                                                                    | Escolhe outra coluna                        |
| Remover do painel                                                        | Tira o card do kanban (não apaga o contato) |

\[\[FOTO]]

#### Adicionar item (card)

1. Na coluna, clique em **+**.
2. Busque e selecione o **contato**.
3. Opcional: valor, descrição curta, data prevista de fechamento, probabilidade e status do funil.
4. Salve.

Também é possível colocar um contato no kanban a partir da tela **Atendimentos**.

\[\[FOTO]]

#### Compartilhar coluna

1. Clique em **Compartilhar** na coluna.
2. Selecione os usuários que devem enxergar e usar aquela coluna.
3. Salve.

\[\[FOTO]]

***

### Automações da coluna

Cada coluna pode ter regras com:

#### Gatilhos

| Gatilho             | Quando dispara               |
| ------------------- | ---------------------------- |
| Ao entrar           | Card entra na coluna         |
| Ao sair             | Card sai da coluna           |
| X dias sem ação     | Card parado há N dias        |
| Antes do vencimento | Horas antes da data prevista |

#### Ações

| Ação                 | Efeito                                    |
| -------------------- | ----------------------------------------- |
| Mover                | Envia o card para outra coluna            |
| Mensagem             | Envia WhatsApp (texto) ou WABA (template) |
| Atribuir responsável | Define o usuário do card                  |
| Webhook              | Chama uma URL externa                     |

Há também **prioridade**, **cooldown** (minutos entre disparos) e interruptor **ativa/inativa**, além de **histórico** de execuções (sucesso/erro).

\[\[FOTO]]

***

### Modo Estatísticas

Visão analítica do funil no período filtrado:

* Valor total, valor ponderado, taxa de conversão (ganhos vs perdidos)
* Itens abertos / ganhos / perdidos
* Gráficos: distribuição de status, valor por coluna, probabilidade média
* Lista de itens **atrasados** (data prevista vencida)
* Timeline de atividades

\[\[FOTO]]

***

### Regras importantes

* Colunas e cards respeitam o **acesso do usuário**; admin pode inspecionar o quadro de outro usuário.
* Só o **dono** edita/exclui a coluna.
* Remover do painel **não exclui** o contato.
* Valor ponderado = valor × probabilidade.
* Automações de mensagem exigem conexão WhatsApp/WABA e, no WABA, template selecionado.
* Contatos também entram no kanban via Atendimento, FlowBuilder, campanhas e integrações (Typebot/n8n), quando configurado.

***

### Mensagens e erros comuns

| Situação                                                 | Comportamento                         |
| -------------------------------------------------------- | ------------------------------------- |
| Falha ao carregar                                        | Erro na tela + botão tentar novamente |
| Coluna criada / card atualizado / compartilhamento salvo | Notificação de sucesso                |
| Automação salva / removida                               | Notificação de sucesso                |
| Contato não selecionado ao criar item                    | Aviso para selecionar o contato       |
| Mensagem WABA sem template                               | Selecione um template WABA            |
| Mensagem WhatsApp sem texto                              | Digite a mensagem                     |
| Sem conexão                                              | Selecione a conexão WhatsApp/WABA     |
| Webhook sem URL                                          | Digite a URL do webhook               |
| Coluna vazia                                             | Mensagem “nenhum card nesta coluna”   |

***

### Dicas de uso

* Monte o funil com poucas colunas claras (ex.: Lead → Negociação → Fechado).
* Use probabilidade e status do funil para a visão **Estatísticas** fazer sentido.
* Compartilhe colunas com a equipe em vez de duplicar o mesmo funil.
* Reserve automações de mensagem para etapas estáveis (evite spam no cliente).
* Filtre por período antes de analisar conversão no modo Estatísticas.
