Webhook

El nodo Webhook es un disparador (trigger) que expone una URL pública. Cuando esa URL recibe una petición HTTP, el workflow arranca automáticamente con el payload recibido como datos de entrada.

Función

Activa el workflow al recibir una petición GET o POST en la URL generada por Floogos. El payload (query params en GET, body en POST) queda disponible para los nodos siguientes.

Configuración

Campo	Tipo	Descripción
url_webhook	Auto	URL generada automáticamente. Se muestra al seleccionar el nodo en el editor.

URLs disponibles

Cada webhook genera dos URLs:

Entorno	Ruta	Uso
PROD	/webhooks/<hash>	Tráfico real. Registra estadísticas y aplica políticas de seguridad.
DEV	/webhooks-dev/<hash>	Idéntico a PROD pero con respuesta extendida para depuración.

Ambas URLs están disponibles en el panel lateral (drawer) de cada webhook en la sección Webhooks de la plataforma.

Respuesta HTTP

El comportamiento de la respuesta varía según el entorno y el nodo final del workflow:

Escenario	PROD (/webhooks/<hash>)	DEV (/webhooks-dev/<hash>)
Workflow termina con webresponse	Código, headers y body configurados en el nodo	Igual que PROD
Workflow ejecutado sin webresponse	{"status": 200}	{"response": {...}, "message": "Workflow lanzado correctamente (METHOD)."}
Error durante la ejecución	{"status": 500}	{"error": "mensaje del error"}

URL de producción (PROD)

La URL de producción devuelve respuestas mínimas para no exponer datos internos:

• Si el workflow termina con un nodo webresponse, la respuesta es completamente personalizable (código HTTP, headers, body JSON).
• En cualquier otro caso, la respuesta se limita a {"status": 200} en caso de éxito o {"status": 500} si ocurre un error.

URL de desarrollo (DEV)

La URL DEV devuelve la respuesta completa del workflow, útil para depuración:

• Si hay webresponse → misma respuesta que PROD.
• Sin webresponse → devuelve el resultado completo del workflow más un mensaje de confirmación.
• En caso de error → devuelve {"error": "mensaje del error"} con el detalle del fallo.

Consejo

Usa la URL DEV para inspeccionar el resultado completo del workflow durante el desarrollo. En producción, controla la respuesta HTTP mediante el nodo webresponse cuando necesites un body o código de estado personalizado.

Datos disponibles en el workflow

El nodo inyecta el objeto _request junto con el payload del cuerpo o query string:

{
  "payload": { "...campos del body o query..." },
  "_request": {
    "method": "POST",
    "timestamp": "2026-04-28T10:00:00.000Z",
    "headers": { "content-type": "application/json" },
    "ip": "1.2.3.4",
    "isDev": false
  }
}

Usos comunes

• Recibir eventos de servicios externos (Stripe, Shopify, GitHub, etc.)
• Procesar envíos de formularios públicos
• Integrar sistemas CRM / ERP mediante HTTP
• Disparar workflows desde scripts o aplicaciones propias

Seguridad

Los webhooks admiten políticas de seguridad configurables desde la plataforma:

• Rate limiting — límite de peticiones por ventana de tiempo (por IP o global)
• Filtrado de IPs — lista blanca o lista negra con soporte CIDR (ej. 10.0.0.0/8)
• Firma HMAC-SHA256 — verifica que el body venga firmado con un secret compartido
• Restricción horaria — permite llamadas solo en días y horas específicos

Consulta la guía completa en Gestión de Webhooks.

Recomendaciones

• Comparte la URL solo con servicios de confianza.
• Activa siempre una política de seguridad en producción para evitar abusos.
• Usa la URL DEV durante el desarrollo para separar el tráfico de pruebas del real.
• Revisa los Insights de acceso para monitorizar el tráfico en tiempo real.

Multi-idioma

• help.es: Activa el trigger de webhook para iniciar un workflow
• help.en: Activate the webhook trigger to start a workflow