Disparadores
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.
Qué hace un disparador
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.
Los siete disparadores
Your Office AI ofrece siete tipos de disparadores que cubren inicios bajo demanda, programados, entrantes, basados en eventos y conversacionales.
| 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. |
| 🗣️ Asistente | Un visitante inicia o termina una conversación con un asistente de IA integrado. | La transcripción de la conversación, un resumen generado por IA y cualquier dato estructurado extraído. | Captación de clientes potenciales, chat de soporte, toma de pedidos y asistentes de reserva integrados en un sitio web. |
Disparadores webhook
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.
Disparadores de programa
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.
Disparadores de evento de integración
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.
Disparadores de vigilante de carpeta
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.
Disparadores de formulario
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.
Disparadores de asistente
Un disparador de Asistente integra un asistente de IA conversacional (texto, voz o un avatar parlante) con el que un visitante interactúa directamente; la propia conversación impulsa el flujo de trabajo. Puedes ramificar según el inicio de la conversación, una acción durante la conversación o su finalización, y los nodos posteriores reciben la transcripción, un resumen generado por IA y los datos estructurados que el asistente haya extraído. Está pensado para captación de clientes potenciales, conversaciones de soporte, toma de pedidos y flujos de reserva integrados directamente en tu sitio. Los flujos de trabajo con disparador de Asistente aparecen en la pestaña Asistentes, donde obtienes el enlace y el código de inserción para compartir, y donde cada conversación con un visitante aparece como una sesión que puedes revisar.
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.