Disparador: Webhook de entrada

O disparador Webhook de entrada inicia um workflow quando qualquer sistema externo envia uma requisição HTTP para a URL única que a Omnifox gera para esse workflow. É a porta de entrada para integrar ferramentas de terceiros sem depender de um canal de mensagens.

Quando usar

Use para conectar a Omnifox ao seu e-commerce ("pedido pago" dispara uma confirmação via WhatsApp), um formulário web, Zapier/Make, ou qualquer sistema que consiga enviar um POST em JSON.

Configuração

Ao adicionar o disparador "Webhook de entrada" a um workflow ativo, a Omnifox gera uma URL no formato /workflows/webhook/{token} (aceita GET e POST). Você configura:

• Correspondência por JSON path: filtra quais requisições disparam o workflow, por exemplo event.type == "order.paid" (vazio = qualquer requisição dispara).

Variáveis disponíveis

• $webhook.payload (corpo JSON completo)
• $webhook.headers (cabeçalhos HTTP recebidos)
• $webhook.timestamp

Exemplo

Workflow "Confirmação de pedido": Disparador = Webhook de entrada, filtro event.type == "order.paid". Ação: criar/atualizar o contato usando o e-mail do payload e enviar um modelo de WhatsApp de confirmação com {{$webhook.payload.order.total}}.

Dicas

• Teste o webhook primeiro com a ferramenta de teste do editor, colando um JSON de exemplo real antes de conectar o sistema externo.
• Guarde a URL gerada em um lugar seguro — qualquer pessoa que a tenha pode disparar o workflow, já que ela só é protegida pelo token.

Solução de problemas

Se o sistema externo recebe erro ou o workflow não dispara, verifique se ele está enviando Content-Type: application/json e se o workflow está ativo (não em rascunho); um token inválido ou um workflow pausado fazem a requisição não ter efeito.