Un disparador es el evento que inicia un flujo de trabajo y suministra los datos iniciales con los que trabajan los demás nodos. Cada flujo de trabajo tiene exactamente un disparador, y siempre es el primer nodo en el lienzo.
Cuando el lienzo está vacío, la biblioteca de nodos solo ofrece disparadores: "todo flujo de trabajo comienza con un disparador." No puedes colocar primero un nodo de IA o de acción. Una vez que se coloca un disparador, se desbloquea la biblioteca completa de nodos.
Además de iniciar la ejecución, un disparador define la forma del payload de entrada que fluye hacia el resto del flujo de trabajo. Los nodos posteriores hacen referencia a ese payload con {{ trigger.output.<campo> }}: un disparador de formulario expone sus campos, un webhook expone el cuerpo de la solicitud y un evento de integración expone el objeto del evento. Elegir el disparador adecuado es la primera decisión de diseño que tomas.
Your Office AI ofrece seis tipos de disparadores que cubren inicios bajo demanda, programados, entrantes y basados en eventos.
| Disparador | Cuándo se activa | Payload de entrada | Uso habitual |
|---|---|---|---|
| ▶️ Manual | Lo ejecutas bajo demanda desde el centro de automatización. | Valores opcionales que introduces al iniciar la ejecución. | Ejecuciones puntuales, pruebas durante la construcción, trabajos por lotes ad-hoc. |
| 🔗 Webhook | Un servicio externo envía un HTTP POST a una URL generada. | El cuerpo JSON y los encabezados de la solicitud entrante. | Eventos de GitHub, notificaciones de pago, aplicaciones y scripts personalizados. |
| ⏰ Programa (cron) | Según un programa cron recurrente o un intervalo fijo. | La hora de ejecución programada. | Informes diarios, resúmenes semanales, sincronizaciones periódicas y recordatorios. |
| 🧩 Evento de integración | Una herramienta conectada emite un evento al que te has suscrito. | El objeto del evento de la integración (p. ej., el nuevo registro). | Nuevo ticket de Jira, nuevo evento de calendario, nueva fila en CRM, nuevo mensaje. |
| 📂 Vigilante de carpeta | Un nuevo documento llega a una carpeta de conocimiento vigilada. | El nuevo documento y sus metadatos. | Procesamiento automático de cargas, canalizaciones de ingesta, clasificación de documentos. |
| 📋 Formulario | Alguien envía un formulario alojado en YOffice. | Los valores de campo enviados. | Formularios de solicitud, peticiones de soporte, solicitudes de aprobación estructuradas. |
Un disparador webhook genera una URL única. Cualquier sistema externo que pueda enviar un HTTP POST puede iniciar el flujo de trabajo llamando a esa URL; el cuerpo de la solicitud se convierte en la salida del disparador. La URL solo se activa una vez que publicas el flujo de trabajo.
Un disparador de programa ejecuta tu flujo de trabajo según un programa cron recurrente o un intervalo fijo: cada mañana, cada lunes, cada quince minutos. Úsalo para informes, resúmenes, sincronizaciones periódicas y recordatorios. Como los webhooks, el programa solo empieza a dispararse una vez que el flujo de trabajo está publicado.
Los disparadores de evento de integración se activan cuando una de tus integraciones conectadas emite un evento: un nuevo ticket, un nuevo evento de calendario, una nueva fila, un mensaje entrante. El objeto del evento se entrega directamente a tu flujo de trabajo, listo para ser analizado, transformado y procesado.
Un disparador de vigilante de carpeta se activa cada vez que se añade un nuevo documento a una carpeta de conocimiento vigilada. Es la base para las canalizaciones de ingesta: extrae, clasifica, resume o enruta automáticamente cada archivo que llega a una carpeta.
Un disparador de formulario genera un formulario rellenable dentro de la app. Defines los campos en el inspector del disparador; cuando alguien envía el formulario, los valores introducidos inician el flujo de trabajo. Los flujos de trabajo con disparador de formulario aparecen en la pestaña Formularios y se pueden compartir. Plantillas y formularios los cubre en profundidad.
Ahora que has elegido cómo comienza un flujo de trabajo, ve lo que puedes conectar después del disparador en la referencia de nodos.