​

Gerenciando pipelines

Este documento explica como criar, configurar e gerenciar pipelines, incluindo a definição de informações básicas, estágios e ações disponíveis.

---

​

Criando um novo pipeline

Para começar a criar um pipeline, use o botão destacado na interface. O botão Novo pipeline permite criar um novo fluxo de etapas para organizar conversas.
Quando nenhum pipeline for criado, o botão Criar Pipeline também será exibido no centro da tela.

---

​

Configurando informações do pipeline

Após iniciar a criação, será exibida a tela de configuração do pipeline. Nesta tela você pode definir:

• Nome do pipeline
  Nome do pipeline que será exibido na listagem.
• Descrição
  Descrição opcional para identificar a finalidade do pipeline.
• Tipo
  Tipo de pipeline, usado para categorização interna.
• Visibilidade
  Define se o pipeline será público ou privado.

---

​

Configurando Estágios

Ainda na tela de criação, você pode configurar as etapas do pipeline. *Estágios representam as fases do fluxo.

• Você pode adicionar novos estágios fornecendo: *Nome artístico
• Descrição (opcional)
• A ordem das etapas define o fluxo da conversa.

---

​

Pipeline criado

Após a criação, o pipeline será exibido na lista. O cartão de pipeline exibe as seguintes informações:

• Nome do pipeline
• Status (Ativo ou Inativo)
• Itens
  Número de conversas associadas ao pipeline.
• Etapas
  Número total de estágios configurados.
• Tipo
  Tipo definido durante a criação.

---

​

Ações de pipeline

Cada pipeline possui um menu de ações acessível através do ícone três pontos. As opções disponíveis são:

• Editar
  Permite editar todas as configurações do pipeline, incluindo nome, descrição, tipo, visibilidade e estágios.
• Duplicado
  Cria uma cópia do pipeline com a mesma estrutura de estágio.
• Desativar
  Desativa o pipeline, impedindo seu uso sem removê-lo do sistema.
• Excluir
  Remove permanentemente o pipeline.

---

​

Acessando o pipeline

Ao clicar em um pipeline, você acessa sua visualização completa no formato Kanban.

​

Visualização Kanban

A visualização Kanban apresenta o pipeline como um quadro de colunas, onde cada coluna representa uma etapa do processo. Esta interface permite visualizar e gerenciar o fluxo da conversa de forma visual e intuitiva.

​

Cabeçalho do pipeline

No topo da visualização, você encontra:

• Nome do pipeline: exibido em um menu suspenso no canto superior esquerdo, junto com a descrição do pipeline
• Métricas: No canto superior direito, são exibidos:
• Itens: Número total de conversas associadas ao pipeline
• Estágios: Número total de estágios configurados
• Botão ”+ Adicionar Item”: Permite adicionar novas conversas diretamente ao pipeline

​

Colunas de palco

Cada estágio é representado por uma coluna vertical no quadro Kanban:

• Nome do estágio: Exibido no topo de cada coluna
• Indicador de cor: Um ponto colorido identifica visualmente cada estágio
• Contador: Mostra quantas conversas existem em cada etapa
• Área de Conteúdo: Exibe conversas associadas ao estágio ou a mensagem “Nenhuma conversa neste estágio” quando vazia

​

Adicionando novos estágios

À direita do último estágio, há um botão “Adicionar estágio” destacado:

• Ícone: Círculo verde com sinal de adição (+)
• Função: Permite criar novas etapas diretamente na visualização Kanban
• Uso: Clique no botão para adicionar uma nova fase ao pipeline sem sair da visualização

​

Recursos disponíveis

Nesta visualização, você pode:

• Veja todas as etapas lado a lado: Acompanhe o andamento completo do fluxo
• Mova conversas entre estágios: arraste e solte conversas para movê-las entre colunas
• Adicionar novos estágios: Use o botão “Adicionar estágio” para expandir o pipeline
• Adicionar novos itens: Use o botão ”+ Adicionar item” para incluir conversas no pipeline
• Acompanhe métricas: veja quantas conversas existem em cada etapa

---

​

Considerações Finais

A gestão do pipeline permite estruturar fluxos de suporte de forma visual e organizada. Com pipelines bem definidos, é possível:

• Acompanhe o progresso: Visualize onde cada conversa está no processo por meio do quadro Kanban
• Padronize processos: Defina etapas claras que reflitam seu fluxo de trabalho real
• Melhore a eficiência: Identifique gargalos e oportunidades de otimização observando a distribuição das conversas entre os estágios
• Organize equipes: Atribua responsabilidades por etapa e acompanhe o desempenho de cada fase
• Automatizar movimentos: configure regras para mover conversas automaticamente entre estágios com base em condições específicas

---

​

Automação de palco

Cada estágio do pipeline pode ter regras de automação configuradas na guia Automação do modal de edição do estágio. As regras seguem o modelo trigger → action:

• Acionadores: label_added, conversation_status_changed, custom_attribute_updated.
• Ações: move_to_stage, assign_agent, apply_label e (começando em v1.0.0-rc3) move_to_pipeline.

​

move_to_pipeline Ação (rc3)

Permite mover o item de pipeline para um pipeline diferente, preservando o id do item. Útil para fluxos como “se o rótulo qualified foi adicionado ao pipeline de Leads, vá para o pipeline de Vendas”. A ação ignora automaticamente a validação same-pipeline (que normalmente impediria a movimentação entre pipelines distintos).

​

Garantias

• Janela de desduplicação de 5s para pipeline_stage_updated por (rule, pipeline_item, stage) — evita disparo contínuo.
• Prevenção de loop — uma regra move_to_stage não aciona recursivamente outra regra do mesmo tipo.
• Logs centralizados em Settings → Automation → Logs — visualize execuções, condições avaliadas e erros.

Para obter o modelo completo de regras de automação, consulte Visão geral e Regras.

---

​

Vinculando produtos a itens (a partir de v1.0.0-rc3)

Cada item do pipeline possui um painel Venda onde você pode registrar qual produto do catálogo está sendo negociado. Útil para relatórios de conversão por produto. O agente AI também pode fazer essa ligação automaticamente durante uma conversa, usando a ferramenta nativa link_product_to_pipeline_item. Quando o cliente confirma o interesse, o agente registra o link sem intervenção manual. Consulte Catálogo de Produtos.

---

​

Ações de pipeline em menus de cartão (começando em v1.0.0-rc3)

Os cartões Kanban agora expõem ações de pipeline por meio do menu de três pontos (⋮) no cartão e por meio do clique com o botão direito (menu de contexto). As ações disponíveis incluem movimentação entre estágios, atribuição de agente, aplicação de rótulo e abertura de detalhes do item. Lembre-se de revisar e ajustar seus pipelines regularmente à medida que sua operação evolui, garantindo que eles continuem a refletir seus processos de negócios de forma eficiente.

---