Webhooks permitem que serviços externos disparem execução de workflow enviando requisições HTTP para seu workflow. ZippyVendas suporta duas abordagens para triggers baseados em webhook.
Trigger de Webhook Genérico
O bloco Generic Webhook cria um endpoint flexível que pode receber qualquer payload e disparar seu workflow:
Como Funciona
- Adicione Bloco de Webhook Genérico - Arraste o bloco Generic Webhook para iniciar seu workflow
- Configure Payload - Configure a estrutura de payload esperada (opcional)
- Obtenha URL de Webhook - Copie o endpoint único gerado automaticamente
- Integração Externa - Configure seu serviço externo para enviar requisições POST para essa URL
- Execução de Workflow - Cada requisição para a URL do webhook dispara o workflow
Recursos
- Payload Flexível: Aceita qualquer estrutura de payload JSON
- Parsing Automático: Dados de webhook são automaticamente parseados e disponíveis para blocos subsequentes
- Autenticação: Autenticação opcional de bearer token ou header customizado
- Rate Limiting: Proteção integrada contra abuso
- Deduplicação: Previne execuções duplicadas de requisições repetidas
O trigger de Webhook Genérico dispara toda vez que a URL do webhook recebe uma requisição, fazendo-a perfeita para integrações em tempo real.
Trigger Mode para Service Blocks
Alternativamente, você pode usar blocos de serviço específicos (como Slack, GitHub, etc.) em "trigger mode" para criar endpoints de webhook mais especializados:
Configurando Trigger Mode
- Adicione Service Block - Escolha um bloco de serviço (ex: Slack, GitHub, Airtable)
- Habilite Trigger Mode - Toggle "Use as Trigger" nas configurações do bloco
- Configure Serviço - Configure autenticação e filtros de evento específicos para esse serviço
- Registro de Webhook - O serviço automaticamente registra o webhook com a plataforma externa
- Execução Baseada em Evento - Workflow dispara apenas para eventos específicos desse serviço
Quando Usar Cada Abordagem
Use Webhook Genérico quando:
- Integrando com aplicações customizadas ou serviços
- Você precisa de máxima flexibilidade em estrutura de payload
- Trabalhando com serviços que não têm blocos dedicados
- Construindo integrações internas
Use Trigger Mode quando:
- Trabalhando com serviços suportados (Slack, GitHub, etc.)
- Você quer filtragem de evento específica do serviço
- Você precisa de registro automático de webhook
- Você quer manipulação de dados estruturados para esse serviço
Serviços Suportados para Trigger Mode
Desenvolvimento & Gerenciamento de Projeto
- GitHub - Issues, PRs, pushes, releases, workflow runs
- Jira - Issue events, worklogs
- Linear - Issues, comments, projects, cycles, labels
Comunicação
- Slack - Messages, mentions, reactions
- Microsoft Teams - Chat messages, channel notifications
- Telegram - Bot messages, commands
- WhatsApp - Messaging events
- Gmail - Novos e-mails (polling), mudanças de label
- Outlook - Novos e-mails (polling), eventos de pasta
CRM & Sales
- HubSpot - Contacts, companies, deals, tickets, conversations
- Stripe - Payments, subscriptions, customers
Formulários & Surveys
- Typeform - Form submissions
- Google Forms - Form responses
- Webflow - Collection items, form submissions
Outro
- Airtable - Record changes
- Twilio Voice - Incoming calls, call status
Segurança e Melhores Práticas
Opções de Autenticação
- Bearer Tokens: Inclua
Authorization: Bearer <token>header - Custom Headers: Defina headers de autenticação customizados
Manipulação de Payload
- Validação: Valide payloads de entrada para prevenir dados malformados
- Limites de Tamanho: Webhooks têm limites de tamanho de payload para segurança
- Manipulação de Erro: Configure respostas de erro para requisições inválidas
Testando Webhooks
- Use ferramentas como Postman ou curl para testar seus endpoints de webhook
- Verifique registros de execução de workflow para debugging
- Verifique que estrutura de payload corresponde suas expectativas
- Teste autenticação e cenários de erro
Sempre valide e sanitize dados de webhook de entrada antes de processá-los em seus workflows.
Casos de Uso Comuns
Notificações em Tempo Real
- Mensagens de Slack disparando respostas automatizadas
- Notificações de e-mail para eventos críticos
Integração de CI/CD
- GitHub pushes disparando workflows de deployment
- Atualizações de status de build
- Pipelines de testes automatizados
Sincronização de Dados
- Mudanças de Airtable atualizando outros sistemas
- Submissões de formulário disparando ações de acompanhamento
- Processamento de pedido de e-commerce
Suporte ao Cliente
- Workflows de criação de ticket de suporte
- Processos de escalação automatizada
- Roteamento de comunicação multi-canal