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.
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
- Abre Workflows → Crear workflow.
- Haz clic en Agregar disparador y elige Webhook entrante.
- 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}. - 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).
- (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. - 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}}. - 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/jsony 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
Artículos relacionados
-
Catálogo de disparadores (triggers) de los workflows
Conoce los eventos que pueden iniciar un workflow automáticamente en Omnifox.
-
Crear tu primera automatizacion (workflow)
Los workflows de Omnifox automatizan tu operacion: un disparador inicia la automatizacion y los nodos de accion hacen el trabajo. Crea un mensaje de bienvenida en minutos.
-
Guía completa de los flujos de trabajo (Workflows)
Los Workflows a fondo, en 54 capítulos: disparadores, nodos, variables, probar, historial, plantillas, importar y exportar, con cada opción explicada y un flujo real de punta a punta.
-
Nodos de acción disponibles en los workflows
Descubre las acciones que un workflow puede ejecutar de forma automática.
-
Condiciones y ramificaciones (si/entonces) en un workflow
Haz que tus flujos tomen decisiones y sigan caminos distintos según los datos de cada contacto.