Board e Pipelines

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.

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.

---

​

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

---

​

Pipeline vinculada ao número inbound

Em Números de Telefone, é 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 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.

Veja Automações para o builder visual e a lista completa de blocos disponíveis.

---

​

Próximos passos