> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Board e Pipelines
> Funis Kanban, etapas com descrição para IA e classificação automática de clientes
O **Board** é a visão em colunas (estilo Kanban) das suas **pipelines** de CRM. Cada pipeline representa um processo — vendas, onboarding, suporte — com **etapas** ordenadas onde os **clientes** aparecem como cartões.
Navegação no painel: **CRM** > **Board**. A lista tabular fica em **CRM** > **[Clientes](/clients)**.
***
## O que é uma pipeline?
Uma pipeline contém:
* **Nome e descrição** — identificação do funil.
* **Etapas (stages)** — colunas ordenadas por **posição**, cada uma com **nome**, **cor**, **descrição** e opcionalmente marcada como **terminal** (etapa de fechamento).
* **Campos de card** (`card_fields_schema`) — definição de campos extras exibidos nos cartões daquele funil (texto, número, data, seleção, etc.).
Uma organização pode ter **várias pipelines**. Cada cliente fica em **no máximo** uma combinação pipeline + etapa por vez.
***
## Por que a descrição da etapa importa?
A plataforma pode **mover automaticamente** o cliente entre etapas **depois de uma sessão de voz com IA** (transcrição/mensagens disponíveis). O modelo de classificação usa o **nome e a descrição** de cada etapa para decidir em qual coluna o cliente deve estar.
Escreva descrições **claras e específicas** para cada etapa: o que caracteriza um lead nessa fase, exemplos de sinais na conversa, o que já foi resolvido ou o que falta. Descrições genéricas reduzem a precisão da movimentação automática.
Configure e edite pipelines pelo diálogo de configuração do Board (inclui reordenação por arrastar, cores e flag **terminal**).
***
## Classificação automática após a chamada
Quando uma **sessão** termina e há **mensagens** da conversa, se o cliente estiver em uma **pipeline** com **etapa atual** definida, o sistema chama um classificador (modelo de linguagem) que:
1. Lê as etapas da pipeline e suas descrições.
2. Compara com o conteúdo da conversa.
3. Sugere a etapa mais adequada — em geral **sem retroceder** no funil, salvo evidência explícita de regressão.
4. Se a etapa mudar, registra uma **atividade** do tipo mudança automática de etapa (com referência à sessão).
Se o cliente **não** estiver em pipeline ou não tiver etapa, a classificação **não** é aplicada.
### Controles de habilitação
A classificação automática pode ser **desabilitada em dois níveis**. Ambos precisam estar ativos para o agente mover o cliente:
| Nível | Onde configurar | Efeito |
| ------------ | ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Pipeline** | Diálogo de configuração do Board (botão **Configurar**) | Desabilitar aqui bloqueia a classificação automática para **todos os clientes** desse funil |
| **Cliente** | Página de detalhe do cliente → seção Pipeline → toggle **Classificação automática por IA** | Desabilitar aqui bloqueia apenas **esse cliente específico**, mesmo que a pipeline esteja habilitada |
O padrão de ambos os toggles é **habilitado**. Pipelines e clientes existentes continuam com o comportamento atual sem nenhuma ação necessária.
Se a **pipeline** estiver com a classificação desabilitada, o toggle do cliente não tem efeito — o agente não moverá nenhum card daquela pipeline, independentemente da configuração individual.
***
## Pipeline vinculada ao número inbound
Em **[Números de Telefone](/phone-numbers)**, é possível associar uma **pipeline** ao número para chamadas **recebidas**.
* Se **ninguém** com aquele telefone existir como cliente, o sistema **cria um cliente** e pode colocá-lo na **primeira etapa** dessa pipeline.
* Se o cliente **já existir** (telefone reconhecido), ele **não** é recolocado na pipeline por essa regra — permanece onde já estava.
Isso padroniza a entrada de novos contatos no funil certo a partir do canal telefônico.
***
## Movimentação manual
* **Arrastar cartões** entre colunas no Board.
* **Ações em lote** na lista de clientes ou no Board (ex.: enviar para discador ou campanha).
* **Adicionar cliente a uma etapa** — fluxo de busca e movimentação para a coluna desejada (com confirmação se já estiver em outra pipeline).
***
## Etapas como gatilho de Automação
Toda mudança de etapa (manual, em lote, classificação automática ou via API) pode disparar uma [Automação](/automations) com o gatilho **`stage_entry`**.
Use isso para criar **réguas reativas** que executam quando o cliente entra numa etapa específica:
* Entrou em "Lead qualificado" → liga com o agente; se não atende, manda WhatsApp em 4h.
* Entrou em "Em atraso D+5" → e-mail de lembrete, depois WhatsApp, depois call do agente de cobrança.
* Entrou em "Cadastrado" → boas-vindas + agendamento da primeira consulta.
O gatilho cobre **todas** as formas de mudança: arrastar no Board, ações em lote, classificação automática pós-call e PATCH via API. Você define a régua uma vez; ela executa para cada cliente que entra na etapa.
Veja [Automações](/automations) para o builder visual e a lista completa de blocos disponíveis.
***
## Próximos passos
Cadastro, importação e contatos múltiplos
Métricas e funil por etapa
Pipeline inbound e atendimento com IA
Outbound em lote com agente de IA
Réguas reativas disparadas por entrada em etapa, intent, tag ou campo