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.

Jun 26, 2026

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

  1. Abra Workflows → Criar workflow.
  2. Clique em Adicionar gatilho e escolha Webhook de entrada.
  3. 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}.
  4. Copie essa URL e cole no sistema externo como destino do webhook (pode ser GET ou POST; o normal é POST com um corpo JSON).
  5. (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.
  6. 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}}.
  7. 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/json e 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp