--- id: "fluxos.automacoes-gatilhos" titulo: "Disparadores de las automatizaciones" resumo: "Los cinco tipos de disparador: horario, Git del proyecto, evento de Elyra, GitHub o GitLab y webhook, con los eventos y filtros de cada uno." idioma: "es" tipo: "referencia" categoria: "quadro" aplicavelDesde: "0.0.16" capabilities: ["automations.create", "automations.edit"] estadoEditorial: "aprovado" nivelEvidencia: "artefato-distribuido" refFonte: "c9111826ca9805943bfb14a0fa634d5180f3a439" revisaoFonte: "2026-10-11" revisor: "mantenedor (2026-10-11)" rota: "/docs/es/fluxos/automacoes-gatilhos/" fonte: "pt-br/fluxos/automacoes-gatilhos.md" caminhoPublico: "docs/publica/es/fluxos/automacoes-gatilhos.md" hashFonte: "sha256:ae1e32b4a5afb3b87374af941d9cb7da885ba25625d53579ce3c09de8ad79805" hashDestaPagina: "sha256:3165a3dc9315eb6aa9a71abb2f8a96ac6a2d4771eedaeec917ec41e723219366" traducaoAssistidaPorIA: true traducaoDesatualizada: false corpoRetido: false --- > Traducción asistida por IA · idioma: ES · fuente: pt-br/fluxos/automacoes-gatilhos.md · fuenteHash: sha256:6a4fbb51f866c2ad3820ebf2c52e5bef843c85a2966978a92c1cea93af16c890 · revisión humana pendiente. El **disparador** es el "cuándo" de la automatización. En la frase del editor, haz clic en **cuando esto ocurra** y elige uno de los cinco tipos. ![Lista de disparadores del editor: Horario, Git del proyecto, Evento de Elyra, GitHub o GitLab y Webhook](/docs/capturas/automacoes/gatilhos-escolher.webp) | Disparador | Se dispara cuando | Necesita | | -------------------- | --------------------------------------------------------------------------------------- | ------------------ | | **Horario** | Llega la hora marcada | Elyra abierto | | **Git del proyecto** | Hay un commit, push, cambio de branch, merge o conflicto en el repositorio del proyecto | Elyra abierto | | **Evento de Elyra** | Un agente termina o te espera, llega un mensaje a una tarjeta, o un comando falla | Elyra abierto | | **GitHub o GitLab** | Se abre o se fusiona un PR, se pide una revisión, falla el CI o se abre una issue | Elyra Cloud activo | | **Webhook** | Otro sistema hace una llamada firmada a la URL de la automatización | Elyra Cloud activo | Los dos últimos aparecen como **Requiere Elyra Cloud activo** y quedan no disponibles mientras el Cloud no esté activo en este computador. ## Horario Elige la repetición: | Forma | Ejemplo | Cuándo usarla | | ------------------- | -------------------------- | --------------------- | | **Todos los días** | Todos los días a las 9:00 | Casi siempre | | **Días laborables** | Días laborables a las 9:00 | Rutina de trabajo | | **Semanal** | Lunes a las 9:00 | Una vez por semana | | **Cada hora** | Cada hora, en el minuto 30 | Se elige el minuto | | **Cron** | `0 9 * * 1-5` | Un horario específico | El cron tiene **cinco campos**: minuto, hora, día, mes y día de la semana. El editor dice si la expresión es válida. También se elige la **zona horaria** (por defecto, la de este computador): un "a las 9" en la zona equivocada se ejecuta a la hora equivocada. Si Elyra está cerrado a la hora marcada, la ejecución no ocurre y queda registrada en el historial. ## Git del proyecto Marca uno o más eventos: | Evento | Cuándo | | -------------------- | ------------------------------------------------------------------------- | | **commit** | Un commit nuevo en el repositorio | | **push** | El push se percibe por el avance de la branch remota; es una aproximación | | **cambio de branch** | La branch en uso cambió | | **merge** | Hubo un merge | | **conflicto** | Apareció un conflicto | El campo **Solo en la branch** limita el disparador: vacío, vale cualquier branch; con un nombre, solo se dispara cuando el evento ocurre con esa branch en uso. Elyra observa el repositorio del proyecto, **también por SSH**, sin instalar nada en la carpeta `.git`. ## Evento de Elyra | Evento | Cuándo | | -------------------------------------------------- | --------------------------------------------------------------------- | | **un agente termine** | Un agente de una tarjeta del proyecto termina su trabajo | | **un agente te espere** | Un agente queda esperando una respuesta o una decisión | | **llegue un mensaje a una tarjeta** | Llega un mensaje a una tarjeta | | **un comando falle o el terminal salga con error** | Un terminal termina con error | | **se cree una tarea en el tablero** | Se guarda una tarea nueva en el tablero de trabajo del proyecto | | **una tarea pase a una columna** | Una tarea cambia de columna; elige la columna de destino en el editor | Los eventos del tablero salen de la propia mutación guardada, sin polling. La automatización que hizo el cambio no se dispara a sí misma; otras automatizaciones pueden reaccionar y el límite de disparos evita ciclos. **De qué tarjeta** filtra los eventos de tarjetas; el valor por defecto es **Cualquier tarjeta del proyecto**. ## GitHub o GitLab Indica el **proveedor**, el **repositorio** con el formato `propietario/nombre` y los eventos: | Evento | GitHub | GitLab | | ----------------------- | -------------------------------------------------------- | ---------------------------- | | **PR abierto** | Pull request abierto | Merge request abierto | | **PR fusionado** | Pull request cerrado como fusionado | Merge request fusionado | | **Revisión solicitada** | Revisión solicitada en un pull request | No hay un evento equivalente | | **CI falló** | Ejecución de workflow, check suite o check run con fallo | Pipeline con fallo | | **Issue abierta** | Issue abierta | Issue abierta | Después de guardar, abre el detalle de la automatización: allí están la **URL** (**Copiar URL**) y el **secreto**, que pegas en el proveedor. El paso a paso está en [Webhook, GitHub y GitLab](/docs/es/fluxos/automacoes-webhook/). ## Webhook Una llamada de otro sistema dispara la automatización. También depende de Elyra Cloud, una URL y un secreto. El paso a paso, con `curl`, está en [Webhook, GitHub y GitLab](/docs/es/fluxos/automacoes-webhook/). ## Por la línea de comandos El disparador va en `--trigger-json`, un objeto JSON con el campo `kind`: | `kind` | Campos | Ejemplo | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | `schedule` | `expression` (cron o RRULE), `timezone`; opcional `dtstart` | `{"kind":"schedule","timezone":"America/Sao_Paulo","expression":"0 22 * * *"}` | | `git-local` | `repoId`, `events` (`commit`, `push`, `branch-change`, `merge`, `conflict`), `branch` (opcional) | `{"kind":"git-local","repoId":"mi-proyecto","events":["commit"]}` | | `elyra-event` | `events` (`agent-finished`, `agent-waiting`, `card-message`, `terminal-error`, `work-item-created`, `work-item-moved`), `cardId` (opcional), `columnId` (obligatorio con `work-item-moved`) | `{"kind":"elyra-event","events":["work-item-moved"],"columnId":"done"}` | | `git-remote` | `provider` (`github` o `gitlab`), `repo` (`propietario/nombre`), `events` (`pr-opened`, `pr-merged`, `review-requested`, `ci-failed`, `issue-opened`) | `{"kind":"git-remote","provider":"github","repo":"empresa/proyecto","events":["pr-opened"]}` | | `webhook` | ninguno | `{"kind":"webhook"}` | - En un disparador `schedule`, los campos de horario vienen del propio JSON; no lo combines con `--trigger`, `--schedule`, `--time`, `--day` ni `--timezone`. - Para cualquier otro `kind`, `--trigger`, `--prompt` y `--provider` siguen siendo obligatorios: son el texto que leen las versiones antiguas de Elyra. - Al editar con `elyra automations edit`, `--trigger-json` reemplaza el disparador entero. ## Límites que valen para todos - **Un disparo cada 30 segundos, por automatización.** Si el disparador se activa de nuevo antes de eso, la ejecución siguiente no ocurre y queda en el historial como **"No ejecutada: límite de disparos"**. - **Cola de apertura.** Si llegan más de 50 eventos mientras Elyra se abre, los sobrantes se descartan y el historial muestra **"No ejecutada: cola de eventos llena"**. - **Sin Cloud, sin cola.** Si el Cloud está apagado cuando llama GitHub, GitLab o el otro sistema, este tiene que reenviar la llamada: Elyra no guarda una cola. ## Ver también - [Crear una automatización](/docs/es/fluxos/automacoes-criar/) - [Acciones](/docs/es/fluxos/automacoes-acoes/) - [Ejecutar ahora y leer el historial](/docs/es/fluxos/automacoes-execucoes/)