> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leme.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Triggers

> Ejecuta agents automáticamente por horario o desde un webhook

## Resumen

Los triggers inician un agent automáticamente. Úselos para trabajos recurrentes, como un briefing diario, o para trabajos basados en eventos, como calificar un nuevo lead cuando se envía un formulario.

Los triggers no reemplazan canales ni integraciones. Los canales son donde las personas hablan con un agent. Las integraciones y conexiones son cómo el agent accede a herramientas externas. Un trigger solo decide cuándo empieza una ejecución.

## Tipos de trigger

**Schedule** ejecuta un agent en un horario configurado. Úselo para rutinas diarias, semanales o basadas en cron. Revise siempre la zona horaria antes de activarlo.

**Webhook** ejecuta un agent cuando un sistema externo envía un evento autenticado. Úselo para formularios, alertas, eventos de ciclo de vida u otras notificaciones externas.

## Antes de empezar

Necesita el rol `Owner` o `Admin` en el workspace para crear y administrar triggers.

Asegúrese de que el agent esté activo y tenga las conexiones o herramientas que necesita. Las ejecuciones por trigger siguen los mismos permisos, reglas de aprobación y acceso a herramientas que las ejecuciones manuales.

## Crear un trigger schedule

1. Abra el agent en el dashboard de Leme.
2. Vaya a la pestaña **Triggers**.
3. Seleccione **New trigger**.
4. Elija **Schedule**.
5. Agregue un nombre y una instrucción claros.
6. Elija un horario diario, semanal o cron.
7. Confirme la zona horaria.
8. Elija el comportamiento de sesión.
9. Cree el trigger.

Use una sesión reutilizada cuando el trabajo se beneficie de continuidad, como briefings recurrentes. Use una sesión nueva por ejecución cuando cada run deba ser independiente.

## Crear un trigger webhook

1. Abra el agent en el dashboard de Leme.
2. Vaya a la pestaña **Triggers**.
3. Seleccione **New trigger**.
4. Elija **Webhook**.
5. Agregue un nombre y una instrucción claros.
6. Elija el comportamiento de sesión.
7. Cree el trigger.
8. Copie la URL del webhook y el secret que muestra Leme.
9. Configure el sistema externo para enviar una solicitud `POST` a esa URL.

<Note>
  El secret del webhook se muestra cuando el trigger se crea o se rota. Guárdelo en el sistema externo antes de cerrar el panel.
</Note>

Si el emisor permite configurar headers, prefiera enviar el secret así:

```text theme={null}
Authorization: Bearer <secret>
```

Para evitar duplicados, envíe un identificador estable del evento:

```text theme={null}
Idempotency-Key: <event-id>
```

Los formatos soportados son JSON, texto plano y formularios URL-encoded. Mantenga los payloads pequeños e incluya solo los datos del evento que el agent necesita.

Los eventos aceptados se responden de inmediato con `202` y un `statusUrl`:

```json theme={null}
{ "received": true, "duplicate": false, "runId": "...", "statusUrl": "/api/v1/runs/..." }
```

Para seguir el run desde tu sistema, consulta el `statusUrl` con un token de API — los estados y el formato de la respuesta son los mismos que en [Ejecutar agentes vía API](/es/api/runs#seguir-el-run).

## Probar un trigger

Use **Preview** para revisar la instrucción que se enviará al agent.

Use **Test** para crear una ejecución de prueba real. Las pruebas pueden ejecutar herramientas reales, solicitar aprobaciones y afectar sistemas conectados, según la configuración del agent.

## Historial de runs

Cada trigger muestra runs recientes con estado, horario, errores y enlaces a la sesión o task relacionada cuando exista.

Los payloads de webhook y secrets no se muestran completos. El dashboard solo muestra resúmenes seguros para ayudar con el troubleshooting.

## Troubleshooting

**No aparece ningún run:** confirme que el trigger está activo, que el agent está activo y que la zona horaria del schedule es correcta.

**El webhook es rechazado:** verifique la URL, el secret, el content type y el tamaño del payload.

**El webhook aparece duplicado:** envíe un `Idempotency-Key` estable para cada evento externo.

**El run está en espera:** el agent puede estar esperando una aprobación humana requerida.

**El run falla después de haber funcionado:** confirme que el usuario que creó el trigger aún tiene acceso al agent y a las conexiones requeridas.

**El trigger genera demasiado volumen:** páuselo, ajuste el horario o el sistema externo, y luego reactive el trigger.