Disparador de webhook genérico
O bloco de webhook genérico cria um endpoint flexível que pode receber qualquer carga útil e ativar seu fluxo de trabalho:Como funciona
- Adicionar bloco de webhook genérico - Arraste o bloco de webhook genérico para iniciar seu fluxo de trabalho
- Configurar carga útil - Configure a estrutura de carga útil esperada (opcional)
- Obter URL do webhook - Copie o endpoint único gerado automaticamente
- Integração externa - Configure seu serviço externo para enviar solicitações POST para esta URL
- Execução do fluxo de trabalho - Cada solicitação à URL do webhook ativa o fluxo de trabalho
Características
- Carga útil flexível: Aceita qualquer estrutura de carga útil JSON
- Análise automática: Os dados do webhook são analisados automaticamente e estão disponíveis para os blocos subsequentes
- Autenticação: Autenticação opcional através de token bearer ou cabeçalho personalizado
- Limitação de taxa: Proteção incorporada contra abusos
- Deduplicação: Evita execuções duplicadas de solicitações repetidas
O disparador de webhook genérico é ativado sempre que a URL do webhook recebe
uma solicitação, tornando-o perfeito para integrações em tempo real.
Modo de disparador para blocos de serviço
Alternativamente, você pode usar blocos de serviço específicos (como Slack, GitHub, etc.) no “modo de disparador” para criar endpoints de webhook mais especializados:Configuração do modo de ativação
- Adicionar bloco de serviço - Escolha um bloco de serviço (ex.: Slack, GitHub)
- Habilitar modo de ativação - Ative “Usar como ativador” nas configurações do bloco
- Configurar serviço - Configure a autenticação e os filtros de eventos específicos para esse serviço
- Registro do webhook - O serviço registra automaticamente o webhook na plataforma externa
- Execução baseada em eventos - O fluxo de trabalho é ativado apenas para eventos específicos desse serviço
Quando usar cada abordagem
Use webhook genérico quando:- Integrar com aplicações ou serviços personalizados
- Precisar de máxima flexibilidade na estrutura da carga útil
- Trabalhar com serviços que não têm blocos dedicados
- Construir integrações internas
- Trabalhar com serviços compatíveis (Slack, GitHub, etc.)
- Quiser filtragem de eventos específica do serviço
- Precisar de registro automático de webhooks
- Quiser tratamento estruturado de dados para esse serviço
Serviços compatíveis com o modo de ativação
Os seguintes blocos de serviço suportam o modo de ativação:- Slack - Mensagens, menções, reações
- GitHub - Eventos de push, PR, issues
- Telegram - Mensagens e comandos de bot
- Gmail - Notificações de e-mail
- WhatsApp - Eventos de mensagens
- Jira - Atualizações de issues, comentários
- Linear - Mudanças de status de issues
- Notion - Atualizações de páginas
Segurança e melhores práticas
Opções de autenticação
- Tokens Bearer: Inclua o cabeçalho
Authorization: Bearer <token> - Cabeçalhos personalizados: Defina cabeçalhos de autenticação personalizados
Tratamento de carga útil
- Validação: Valide as cargas úteis recebidas para prevenir dados malformados
- Limites de tamanho: Os webhooks têm limites de tamanho de carga útil por segurança
- Tratamento de erros: Configure respostas de erro para solicitações inválidas
Testes de webhooks
- Use ferramentas como Postman ou curl para testar seus endpoints de webhook
- Revise os logs de execução do fluxo de trabalho para depuração
- Verifique se a estrutura da carga útil corresponde às suas expectativas
- Teste cenários de autenticação e erros
Sempre valide e sanitize os dados recebidos do webhook antes de processá-los
em seus fluxos de trabalho.
Casos de uso comuns
Notificações em tempo real
- Mensagens do Slack que disparam respostas automatizadas
- Notificações por e-mail para eventos críticos
Integração CI/CD
- Pushes do GitHub que disparam fluxos de trabalho de deploy
- Atualizações do status de build
- Canais automatizados de testes
Sincronização de dados
- Mudanças no Linear que atualizam outros sistemas
- Envios de formulários que disparam ações de acompanhamento
- Processamento de pedidos de e-commerce
Atendimento ao cliente
- Fluxos de trabalho de criação de tickets de suporte
- Processos automatizados de escalonamento
- Roteamento de comunicação multicanal