Skip to main content
Usa el trigger webhook cuando otro sistema deba decidir cuándo iniciar la automatización. Cada solicitud válida crea una ejecución.

Configuración

No envíes un secreto al crear la automatización. La plataforma genera trigger.secret y lo devuelve en la respuesta.

Cómo iniciarlo

1

Crea la automatización

Usa { "type": "webhook" } en trigger.
2

Publica y activa

Una automatización sin versión publicada o desactivada no acepta solicitudes.
3

Envía una solicitud

Haz POST a la URL que contiene workflowId y secret. Consulta Disparar webhook.

Datos disponibles en los pasos

El JSON que envías queda en trigger.body. Los headers y parámetros de URL quedan en trigger.headers y trigger.query. Envía Content-Type: application/json. La API rechaza bodies mayores a 50 MB, pero ese valor no garantiza que un evento de ese tamaño pueda guardarse como ejecución. Mantén el body pequeño y guarda archivos en almacenamiento externo. Si envías:
puedes preparar el input de un paso así:

Cuándo se acepta la solicitud

La API crea una ejecución cuando:
  • el workflowId existe;
  • el secret de la URL coincide;
  • el trigger sigue siendo webhook;
  • la automatización está publicada y activa;
  • la cuenta no alcanzó su límite de ejecuciones activas.
Una solicitud aceptada responde 202 con un runId. Consulta Disparar webhook para ver la URL, respuesta y errores.
Este trigger no deduplica solicitudes. Si tu cliente reintenta el mismo POST, la plataforma crea otra ejecución. Incluye un ID propio en el body y consulta Reintentos e idempotencia.

Cuándo usar otro trigger

Relacionado