Disparador: Webhook entrante

El disparador Webhook entrante arranca un workflow cuando cualquier sistema externo envía una solicitud HTTP a la URL única que Omnifox genera para ese workflow. Es la puerta de entrada para integrar herramientas de terceros sin depender de un canal de mensajería.

Cuándo usarlo

Usalo para conectar Omnifox con tu e-commerce ("pedido pagado" dispara una confirmación por WhatsApp), un formulario web, Zapier/Make, o cualquier sistema que pueda hacer un POST con JSON.

Configuración

Al agregar el disparador "Webhook entrante" a un workflow activo, Omnifox genera una URL con la forma /workflows/webhook/{token} (acepta GET y POST). Configurás:

• Coincidencia por JSON path: filtrá qué solicitudes disparan el workflow, por ejemplo event.type == "order.paid" (vacío = cualquier solicitud dispara).

Variables disponibles

• $webhook.payload (cuerpo JSON completo)
• $webhook.headers (cabeceras HTTP recibidas)
• $webhook.timestamp

Ejemplo

Workflow "Confirmación de pedido": Disparador = Webhook entrante, filtro event.type == "order.paid". Acción: crear/actualizar el contacto usando el email del payload y enviarle una plantilla de WhatsApp de confirmación con {{$webhook.payload.order.total}}.

Consejos

• Probá el webhook primero con la herramienta de test del editor pegando un JSON de ejemplo real antes de conectar el sistema externo.
• Guardá la URL generada en un lugar seguro — cualquiera que la tenga puede disparar el workflow, ya que solo está protegida por el token.

Solución de problemas

Si el sistema externo recibe error o el workflow no dispara, verificá que esté enviando Content-Type: application/json y que el workflow esté activo (no en borrador); un token inválido o un workflow pausado hacen que la solicitud no tenga efecto.