Visão geral
Automation Alerts via Webhook entrega notificações em tempo real para cada execução de automação no Pipefy, tanto bem-sucedidas quanto com falha. Você configura um endpoint de webhook por pipe e passa a receber automaticamente o status de cada execução, com contexto de causa raiz em caso de erros.
O que há de novo?
- Webhook de execução de automações: configure um endpoint via API do Pipefy com a ação automation.execution para receber alertas de cada execução, incluindo sucessos e falhas.
- Payload completo: cada notificação inclui nome da automação, gatilho, ação executada, status (sucesso ou falha), duração, e informações do card e do pipe.
- Contexto de causa raiz em falhas: quando uma execução falha, o payload inclui o motivo: campo condicional incorreto, violação de campo obrigatório, campo vazio, entre outros.
- Filtros por gatilho e tipo de ação: 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 falhas: seu time é notificado no momento em que uma automação falha, sem precisar monitorar manualmente ou aguardar um cliente reportar o problema.
- Diagnóstico mais rápido: o contexto de causa raiz chega junto com o alerta, reduzindo o tempo de investigação e resolução de incidentes.
- Monitoramento centralizado: conecte os alertas a ferramentas que seu time já usa: dashboards, canais de notificação, plataformas de BI.
- Rastreabilidade de execuções: cada execução fica registrada com duração e status, criando histórico auditável para revisão de saúde dos processos.
Casos de uso
1. Time de TI monitora saúde de automações via Datadog
Um analista de TI configura um webhook no pipe de onboarding de fornecedores apontando para um endpoint do Datadog. A cada execução de automação, o payload chega com status, duração e nome da ação. Quando uma automação de atualização de campo falha por campo obrigatório não preenchido, um alerta é criado automaticamente no Datadog. O analista identifica qual fase do processo gerou a falha sem precisar abrir o Pipefy.
2. Ops recebe falhas críticas direto no Slack
O time de operações de compras configura um webhook no pipe de aprovação de pedidos integrado a um canal do Slack. Quando uma automação de movimentação de card falha por violação de condicional, a mensagem chega no canal com o nome da automação, o card afetado e a causa da falha. O time age em minutos, sem aguardar o solicitante perceber que o pedido travou.
3. Gestor de processos acompanha eficiência de automações no Power BI
Um gestor configura webhooks nos principais pipes da empresa, enviando os payloads para um endpoint que alimenta o Power BI. Com os dados de status, duração e tipo de ação, ele monta um painel de saúde de automações por pipe, identificando quais processos têm maior taxa de falha e em quais fases os erros se concentram.
4. Time de TI detecta erros de integração antes que o processo trave
Em um pipe de integração com ERP, automações de atualização de campo dependem de dados vindos de sistemas externos. Com o webhook configurado, quando um campo chega vazio e a automação falha, o alerta chega imediatamente para o time responsável pela integração. A correção acontece antes que outros cards do mesmo processo sejam afetados.
5. Service Account centraliza monitoramento em ambiente multi-pipe
Um administrador de Pipefy configura webhooks em todos os pipes críticos usando uma Service Account, com os alertas apontando para um sistema de monitoramento central. A equipe passa a ter visão consolidada da saúde das automações em toda a empresa, com histórico de execuções e padrões de falha identificáveis ao longo do tempo.
Mais relevante para
- Times de TI responsáveis pela manutenção e governança de processos no Pipefy
- Pipe Admins que gerenciam automações em pipes críticos
- Analistas de operações que precisam de visibilidade sobre execuções de automações
- Arquitetos de processo que monitoram a saúde de fluxos em múltiplos pipes
Documentação
Para o passo a passo completo, consulte a documentação para desenvolvedores.
