Trigger de webhook entrante

El disparador Webhook entrante deja que un sistema externo inicie un workflow de Omnifox con una petición HTTP. Conecta tiendas, ERPs, formularios y pagos.

Jun 26, 2026

Mira este paso en el video · Programados y webhook entrante

El disparador Webhook entrante permite que un sistema externo inicie un workflow de Omnifox enviando una petición HTTP. Es la puerta de entrada para conectar tu tienda, tu ERP, formularios, pasarelas de pago o cualquier app que pueda llamar a una URL: cuando ocurre algo de su lado (un pedido pagado, un lead nuevo, un envío despachado), tu workflow reacciona al instante.

Requisitos

  • Plan que incluya acceso a la API de Omnifox.
  • Una herramienta externa capaz de hacer una petición HTTP (Zapier, Make, tu backend, etc.).

Pasos

  1. Abre Workflows → Crear workflow.
  2. Haz clic en Agregar disparador y elige Webhook entrante.
  3. Guarda el workflow: Omnifox genera automáticamente una URL de webhook entrante única con un token secreto, del tipo https://omnifox.io/workflows/webhook/{token}.
  4. Copia esa URL y pégala en el sistema externo como destino del webhook (puede ser GET o POST; lo normal es POST con un cuerpo JSON).
  5. (Opcional) En el filtro Coincidencia por JSON path limita el flujo a ciertos eventos, por ejemplo event.type == "order.paid", para que solo dispare cuando el payload cumpla la condición.
  6. En tus nodos usa los datos recibidos con las variables {{$webhook.payload}} (cuerpo JSON completo), {{$webhook.headers}} y {{$webhook.timestamp}}. Puedes navegar el JSON, p. ej. {{$webhook.payload.customer.email}}.
  7. Activa el workflow.

Verificación

Haz que el sistema externo envíe un evento de prueba (o usa el botón Probar del editor pegando un JSON de ejemplo). Una llamada exitosa responde {"ok":true} con HTTP 200. Luego abre la pestaña Ejecuciones para confirmar que el workflow corrió y revisar qué llegó en $webhook.payload.

Si no funciona

  • HTTP 404 (not_found): la URL/token es incorrecta o el workflow no está Activo y con disparador Webhook entrante. Vuelve a copiar la URL desde el editor.
  • El flujo no avanza: revisa el filtro de JSON path; si la condición no se cumple, el workflow no continúa.
  • Faltan datos en los nodos: confirma que el sistema externo envía Content-Type: application/json y que la ruta a la variable coincide con la estructura real del JSON.

Tip: trata la URL del webhook como un secreto. Quien la tenga puede disparar tu workflow. Si se filtra, vuelve a guardar el workflow para rotar el token.

Tip: ¿no controlas el formato del sistema externo? Usa Zapier o Make como intermediario para darle forma al JSON antes de enviarlo a Omnifox.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp