Trigger por webhook

Un trigger por webhook lanza el proceso cuando otro sistema lo llama por HTTP: un bot de WhatsApp (Mosend), un flujo de n8n, el sistema del cliente. El cuerpo de la llamada llega al proceso como sus entradas y, si quien llama puede esperar, recibe las salidas en la misma respuesta.

¿Y para lanzarlo a mano?

No hace falta un trigger: en Centro › Robots › Ejecuciones › Iniciar ejecución eliges el proceso y lo lanzas. Ver Ejecutar manualmente.

Crear el trigger

1. Abre Centro › Robots › Disparadores y pulsa Nuevo disparador.
2. En Qué ejecuta, elige Un proceso y cuál.
3. En Cuándo corre, elige Otro sistema lo llama. Define la Espera máxima por la respuesta (segundos, 0–60); por defecto 25. Es el tope que puede pedir quien llama para recibir el resultado en la misma respuesta.
4. En Dónde corre, elige la máquina y, si el proceso es de Windows, la sesión de robot: es obligatoria para correr desatendido.
5. Si el proceso declara entradas, completa sus valores por defecto: lo que llegue en el cuerpo de la llamada los sobrescribe.
6. En Revisar y crear, ponle un nombre (ej. Consulta de factura desde WhatsApp) y pulsa Crear disparador.

La fila del trigger muestra su URL con el botón para copiarla, y cuántas veces se ha disparado. La URL lleva una clave (wk_…) que es la autenticación: no necesita usuario ni token.

Trata la URL como una contraseña

Quien tenga la URL puede lanzar el proceso. Compártela solo con el sistema que la usa. Si se filtra, usa Rotar llave en el menú ⋮ del disparador: la URL anterior deja de funcionar al instante y hay que poner la nueva en el sistema que llama.

Llamarlo

curl -s -X POST "https://<tu-api>/public/triggers/wk_...?wait=25" \
  -H "Content-Type: application/json" \
  -d '{"cliente":"ACME","factura":"FV-1001"}'

• Cuerpo: un objeto JSON se pasa tal cual como entradas del proceso. Cualquier otra cosa (texto, una lista) llega envuelta en { "payload": … }. Las claves que empiezan por _ se reservan y se descartan.
• ?wait=N (o la cabecera X-Zoan-Wait): segundos que la llamada espera el resultado, hasta el tope del trigger. Sin wait, la llamada vuelve de inmediato.

Respuesta	Cuándo
200 con outputs	El proceso terminó dentro de la espera.
202 con execution_id	Sigue corriendo (o no se pidió espera). Consulta después GET /public/triggers/<clave>/executions/<execution_id>.
404	La clave no existe (o se regeneró).
409	El trigger está apagado, el proceso no tiene versión publicada o falta la sesión de robot.
429	Demasiadas llamadas: hasta 120 por minuto por clave y origen.

Bots conversacionales

Un bot de WhatsApp suele cortar a los ~25 s. Pide wait=25 y diseña el proceso para responder dentro de ese tiempo; si algo tarda más, devuelve un «te aviso» y termina el trabajo en segundo plano.

Siguientes pasos

• Iniciar casos de un flujo — el mismo webhook puede iniciar un flujo completo, con clave de idempotencia.
• Trigger programado — lanzar el proceso a una hora o frecuencia fija.
• Trigger por cola — lanzarlo cuando una cola tiene trabajo.
• Estados y ciclo de vida — qué pasa con la ejecución que se crea.