Visão geral
AI Agent Alerts via Webhook entrega notificações em tempo real para cada execução de AI Agent no Pipefy, com sucesso ou falha. Você configura um endpoint de webhook por pipe e passa a receber automaticamente o resultado de cada execução, com contexto do que o agente fez e por que falhou.
O que há de novo?
- Webhook de execução de AI Agents: configure um endpoint via API do Pipefy com o evento agent.ai_execution para receber alertas de cada execução, incluindo sucessos e falhas.
- Payload contextualizado: cada notificação inclui status (sucesso ou falha), dados do card e do pipe, e se o agente realizou alguma ação.
- Contexto de falhas: quando um agente falha, o payload inclui o raciocínio, cada etapa que o agente percorreu e onde parou, permitindo identificar a causa raiz sem investigação manual.
- Filtros por status, trigger e resultado: cada webhook pode ser configurado com filtros específicos, entregando apenas os alertas relevantes para aquele pipe.
- Requer Pipe Admin ou Service Account para criação do webhook.
Como isso ajuda?
- Visibilidade proativa sobre AI Agents em produção: seu time é notificado no momento em que um agente falha, sem precisar acessar o Pipefy para descobrir o que aconteceu.
- Diagnóstico mais rápido: o contexto de raciocínio e etapas chega junto com o alerta, reduzindo o tempo de investigação.
- Monitoramento centralizado: conecte os alertas a ferramentas que seu time já usa: Datadog, Grafana, Slack, Teams, Power BI ou qualquer endpoint externo.
- Rastreamento de processos automatizados por IA: cada execução registrada com contexto completo, pronta para acompanhamento e revisão operacional.
Casos de uso
1. Time de TI monitora agente de triagem de incidentes no Datadog
Um AI Agent classifica e roteia chamados de suporte interno. O webhook envia cada execução para o Datadog, onde o time acompanha volume de ações, taxa de falha e tempo médio de execução´, sem precisar acessar o Pipefy.
2. Notificação automática no Slack quando agente de onboarding falha
Um agente responsável por ativar etapas de onboarding falha em um card por campo obrigatório vazio. O webhook dispara uma mensagem no canal de operações com o card, a etapa que falhou e o motivo exato, permitindo correção imediata.
3. Power BI monitora agente de aprovação de compras
Um AI Agent avalia e aprova requisições de compra com base em política interna. O webhook alimenta um dashboard com taxa de aprovação automática, itens escalados para revisão humana e tempo médio de decisão.
4. Sales Operations detecta padrões de falha em agente de qualificação de leads
Um agente qualifica leads recebidos via integração e falha repetidamente em um campo mal mapeado. O webhook envia os detalhes de cada falha para o Metabase, onde o time identifica o padrão e corrige antes que o problema escale.
Mais relevante para
- Times de TI e Platform Engineers que monitoram processos automatizados por IA
- Ops e Sales Operations que operam AI Agents em fluxos críticos de negócio
- Pipe Admins responsáveis por agentes em produção
Documentação
Para o passo a passo completo, consulte a documentação de webhooks na API da Pipefy.
