👤 Para quem já conectou o Pipefy ao assistente de IA
🔐 Disponível nos planos pagos
🎯 Para quem acabou de fazer a conexão e quer saber por onde começar
Com o Pipefy conectado, o assistente enxerga os processos como ferramentas que ele pode chamar. Você digita o que precisa em linguagem natural, ele escolhe a ferramenta certa, executa e traz o resultado.
Este artigo cobre seis comandos em ordem crescente de complexidade. Cada um traz um marcador indicando se ele roda em qualquer conexão ou se exige a instalação local, porque essa é a diferença que mais gera dúvida no começo.
📖 O que você vai encontrar aqui:
Como o assistente decide o que fazer
Quando você digita um pedido, o assistente analisa o que você quer, consulta as ferramentas disponíveis e escolhe a sequência de chamadas necessária. Para pedidos simples, uma ferramenta basta. Para pedidos mais complexos, ele encadeia várias, usando o resultado de uma como entrada da próxima.
Você não precisa saber os nomes das ferramentas. Mas entender esse mecanismo ajuda a formular pedidos melhores e a interpretar respostas inesperadas.
Quanto mais específico o pedido, mais precisa a resposta. Informe o nome exato do pipe, a fase ou o período. Pedidos vagos fazem o assistente adivinhar, e adivinhar em um pipe com muitas fases parecidas é onde ele erra.
Um detalhe importante antes de começar: o que é "aprovar" para o Pipefy
Você vai ver exemplos como "aprove o pedido #4471" ao longo desta série. Vale saber o que acontece por baixo, porque isso muda o que você digita.
Não existe uma ferramenta chamada "aprovar". No modelo do Pipefy, aprovação é o jeito como você modelou aquele momento do processo: pode ser mover o card para a fase seguinte, pode ser preencher um campo de decisão, pode ser acionar uma automação. O assistente executa a aprovação da forma como ela está modelada no seu pipe.
Se o seu processo trata aprovação de uma forma específica, diga isso no pedido: "mova o card do pedido #4471 para a fase Aprovado" é mais direto do que "aprove o pedido #4471", e funciona em qualquer modelagem.
Os seis comandos
1. Liste os pipes da sua organização
✓ Funciona nos dois caminhos de conexão
O melhor ponto de partida. Serve para confirmar que a conexão funciona e para descobrir os nomes exatos dos pipes antes de fazer pedidos mais específicos.
Você digita: Liste todos os pipes da minha organização
Pipefy executa: busca os pipes aos quais a sua conta tem acesso
O que retorna: nomes e identificadores de cada pipe
Se você tem acesso a mais de uma organização, especifique: "liste os pipes da organização [nome]". O assistente filtra automaticamente.
2. Quais cards merecem atenção agora
✓ Funciona nos dois caminhos de conexão
Um dos pedidos mais úteis no dia a dia. Em vez de percorrer visualmente todos os cards, você pede ao assistente que leia a estrutura e aponte onde concentrar energia.
Você digita: No meu pipe de [nome], quais cards eu deveria focar agora?
Pipefy executa: carrega a estrutura do pipe, as fases, os cards e a contagem por fase, e aplica critérios de prioridade
O que retorna: lista de cards com justificativa para cada recomendação
Se a resposta vier incompleta, os dados não foram perdidos: as ferramentas de listagem são paginadas, então o assistente recebe uma página por vez e continua pedindo as seguintes conforme precisa. Para um recorte direto, peça específico: "mostre os 5 cards com mais tempo parado na fase de Aprovação".
3. Recomendações de melhoria para um pipe
✓ Funciona nos dois caminhos de conexão
Aqui o assistente vai além da consulta. Ele lê fases, automações, campos e agentes configurados, identifica gargalos e configurações que podem ser otimizadas, e traz sugestões concretas.
Você digita: Quero recomendações de melhorias no pipe [nome]
Pipefy executa: lê fases, distribuição de cards, automações com suas condições e ações, campos e AI Agents existentes
O que retorna: lista de recomendações com diagnóstico e ação sugerida para cada ponto
O diagnóstico é leitura e não altera nada no pipe. Você pode pedir sem risco, ler as sugestões e decidir depois o que aplicar. A série tem um artigo dedicado a esse fluxo completo.
4. Defina um SLA em uma fase
🔓 Requer instalação local · exige habilidade de admin no pipe
O primeiro comando que escreve no processo. O SLA no Pipefy é uma propriedade da fase, não uma regra dentro de uma automação, então é a fase que o assistente altera.
Você digita: No pipe [nome], defina um SLA de 24 horas na fase de Aprovação
Pipefy executa: localiza a fase e grava o prazo de 86.400 segundos na configuração dela
O que retorna: confirmação da fase atualizada com o novo prazo
Uma automação pode reagir a um SLA estourado, movendo o card ou notificando alguém. Mas o prazo em si mora na fase, não dentro da automação. Se você pedir para configurar o prazo dentro de uma automação, o assistente vai procurar algo que não existe nesse formato.
Este comando aplica a mudança na hora. Fora de exclusões, o assistente não devolve prévia antes de escrever. Em pipe de produção com volume, vale conferir a fase antes de pedir.
5. Consulte o consumo de créditos de IA
✓ Funciona nos dois caminhos de conexão
Uma consulta que antes exigia navegar até o relatório certo dentro da plataforma. O consumo é um dado da organização, então a resposta cobre a organização inteira, não o seu uso individual.
Você digita: Quantos créditos de IA foram gastos na minha organização este mês?
Pipefy executa: acessa os dados de consumo de IA da organização
O que retorna: total de créditos consumidos, com detalhamento por agente ou automação quando disponível
6. Crie um pipe completo a partir de uma descrição
🔓 Requer instalação local · exige admin da organização
O comando mais impressionante da série. Você descreve o processo em uma frase e o assistente monta a estrutura: fases, campos e formulário inicial.
Você digita: Na minha organização [nome], crie um pipe para gerir um processo de recrutamento e seleção
Pipefy executa: cria o pipe, as fases do fluxo, os campos de cada fase e o formulário inicial
O que retorna: confirmação com o pipe criado e a estrutura que ele montou
Processos conhecidos, como recrutamento ou compras, o assistente monta direto. Para processos específicos do seu negócio ele vai perguntar como o fluxo funciona antes de criar. Responder com as etapas na ordem certa é o que faz a diferença no resultado.
Depois de criado, o pipe aparece imediatamente na sua organização. O próximo passo natural é pedir automações e agentes para as fases que precisam, o que a série cobre em artigos dedicados.
Referência rápida
As duas dimensões que determinam se um comando vai rodar para você:
| Comando | Caminho de conexão | Permissão |
|---|---|---|
| 1. Listar pipes | Hospedado ou local | Membro do pipe |
| 2. Cards que merecem atenção | Hospedado ou local | Membro do pipe |
| 3. Recomendações de melhoria | Hospedado ou local | Membro do pipe |
| 4. Definir SLA em uma fase | Local | Admin no pipe |
| 5. Créditos de IA | Hospedado ou local | Acesso à organização |
| 6. Criar um pipe | Local | Admin da organização |
Se um comando de escrita retornar que a ferramenta não existe, o motivo provável é a conexão hospedada. Se retornar erro de permissão no meio da execução, o motivo é habilidade de admin no pipe. São causas diferentes e soluções diferentes.
Antes de avançar, confirme que você:
☐ Testou o comando 1 e recebeu a lista de pipes
☐ Sabe qual caminho de conexão você usou e o que ele habilita
☐ Entende que o assistente executa a aprovação do jeito que ela está modelada no seu pipe
☐ Sabe reformular um pedido quando a resposta vier incompleta
