Gatilho de webhook de entrada
O gatilho Webhook de entrada deixa um sistema externo iniciar uma automação da Omnifox com uma requisição HTTP. Conecte lojas, ERPs, formulários e pagamentos.
Veja este passo no vídeo · Agendados e webhook recebido
O gatilho Webhook de entrada permite que um sistema externo inicie uma automação da Omnifox enviando uma requisição HTTP. É a porta de entrada para conectar sua loja, seu ERP, formulários, gateways de pagamento ou qualquer app que possa chamar uma URL: quando algo acontece do lado deles (um pedido pago, um lead novo, um envio despachado), seu workflow reage na hora.
Requisitos
- Um plano que inclua acesso à API da Omnifox.
- Uma ferramenta externa capaz de fazer uma requisição HTTP (Zapier, Make, seu backend, etc.).
Passos
- Abra Workflows → Criar workflow.
- Clique em Adicionar gatilho e escolha Webhook de entrada.
- Salve o workflow: a Omnifox gera automaticamente uma URL de webhook de entrada única com um token secreto, do tipo
https://omnifox.io/workflows/webhook/{token}. - Copie essa URL e cole no sistema externo como destino do webhook (pode ser GET ou POST; o normal é POST com um corpo JSON).
- (Opcional) No filtro Correspondência por JSON path, limite o fluxo a certos eventos, por exemplo
event.type == "order.paid", para que dispare somente quando o payload atender à condição. - Nos seus nós, use os dados recebidos com as variáveis
{{$webhook.payload}}(corpo JSON completo),{{$webhook.headers}}e{{$webhook.timestamp}}. Você pode navegar pelo JSON, ex.:{{$webhook.payload.customer.email}}. - Ative o workflow.
Verificação
Faça o sistema externo enviar um evento de teste (ou use o botão Testar do editor colando um JSON de exemplo). Uma chamada bem-sucedida responde {"ok":true} com HTTP 200. Depois abra a aba Execuções para confirmar que o workflow rodou e inspecionar o que chegou em $webhook.payload.
Se não funcionar
- HTTP 404 (not_found): a URL/token está incorreta, ou o workflow não está Ativo com o gatilho Webhook de entrada. Copie a URL novamente do editor.
- O fluxo não avança: revise o filtro de JSON path; se a condição não for atendida, o workflow não continua.
- Faltam dados nos nós: confirme que o sistema externo envia
Content-Type: application/jsone que o caminho da variável coincide com a estrutura real do JSON.
Dica: trate a URL do webhook como um segredo. Quem a tiver pode disparar seu workflow. Se vazar, salve o workflow novamente para rotacionar o token.
Dica: não controla o formato do sistema externo? Use Zapier ou Make como intermediário para moldar o JSON antes de enviá-lo à Omnifox.
Artigos relacionados
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.