Rutinas

Ejecuta trabajo según un calendario o desde un webhook. Crea una rutina, añade disparadores, define variables y reglas de solapamiento, ejecútala a mano y consulta su historial.

Veyra Docs TeamActualizado el 3 min de lecturaVersión 2 · Historial

Una rutina crea una tarea para un agente una y otra vez: según un calendario, cuando uno de tus sistemas llama a un webhook o cuando pulsas Run now. Úsala para informes diarios, revisiones semanales, reacciones a alertas o cualquier cosa que deba ocurrir sin que nadie tenga que acordarse de pedirla.

Antes de empezar

Necesitas el permiso Manage routines (routines:manage) y al menos un agente.

Crea una rutina

  1. Abre Routines y selecciona New routine.
  2. Dale un título, el agente que hace el trabajo y, si quieres, un proyecto.
  3. Escribe la petición: la descripción de la tarea que el agente recibe en cada ejecución.
  4. Selecciona Create. La rutina existe, pero no hace nada hasta que tenga un disparador o la ejecutes.

Variables

Escribe {{name}} en la petición para declarar una variable, por ejemplo Summarize tickets from {{week}}. Cada variable puede tener una etiqueta, un tipo (texto, número, sí/no, una opción, una fecha), un valor por defecto y un interruptor Required. Una ejecución debe aportar cada variable obligatoria que no tenga valor por defecto.

Añade un disparador

Abre la sección Triggers de la rutina y selecciona Add trigger.

Tipo Inicia una ejecución cuando Ajustes
Schedule Vence la expresión cron en la zona horaria elegida. Expresión cron, zona horaria.
Webhook Tu sistema envía una solicitud firmada a la URL del disparador. Modo de firma, ventana contra repeticiones.
API Alguien llama al endpoint de ejecución con este disparador. Ninguno.

Un calendario como 0 9 * * 1-5 con la zona horaria Europe/Istanbul se ejecuta a las 09:00, hora de Estambul, cada día laborable.

Para un webhook, la consola muestra la URL y, una sola vez, el secreto. Tu emisor firma cada solicitud con él. Los webhooks tienen su propia página: Webhook de disparo de rutinas.

Cuando las ejecuciones se solapan

Elige qué ocurre cuando vence una ejecución mientras la anterior sigue trabajando:

Ajuste Efecto
Coalesce if active La nueva ejecución se une a la activa en lugar de iniciar otra.
Skip if active La nueva ejecución se omite y queda registrada como omitida.
Always enqueue Se conserva cada ejecución y empieza cuando le toca.

Y qué pasa con las ejecuciones perdidas mientras la rutina estaba en pausa:

Ajuste Efecto
Skip missed Las ejecuciones perdidas se descartan.
Enqueue missed (with a cap) Las ejecuciones perdidas se crean al reanudar, hasta un límite.

Ejecútala a mano

Selecciona Run now, rellena las variables que haya y confirma. La ejecución crea su tarea de inmediato.

Qué hace una ejecución

Cada ejecución crea una tarea, asignada al agente de la rutina (o al agente que elijas para esa ejecución), y despierta a ese agente. La tarea es normal: puedes seguirla, responder y ver su coste. Los límites de pausa, acceso y presupuesto se siguen aplicando, así que una rutina nunca gasta más allá de un presupuesto.

Historial y revisiones

  • Runs lista cada ejecución con su origen (calendario, webhook, API o manual), su estado y la tarea que creó.
  • History lista las versiones de configuración: cada cambio en la petición, el agente o los disparadores crea una revisión que puedes restaurar.

Pausa o archiva

Pon la rutina en Paused para detener las nuevas ejecuciones conservando los disparadores, o en Archived para retirarla. Las llamadas de webhook a una rutina en pausa o archivada se rechazan con 409.

Desde la API

Crea una rutina, añade un calendario e inicia una ejecución:

curl
ROUTINE_ID=$(curl -s -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/routines" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"title": "Weekly support summary", "description": "Summarize tickets from {{week}}.", "assigneeAgentId": "'"$AGENT_ID"'"}' | jq -r .id)

curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/triggers" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind": "schedule", "cronExpression": "0 9 * * 1", "timezone": "Europe/Istanbul"}'

curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/run" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"source": "api", "variables": {"week": "2026-W46"}, "idempotencyKey": "support-2026-w46"}'

Un idempotencyKey repetido devuelve la primera ejecución en lugar de iniciar otra, así que los reintentos son seguros.

Consulta Create a routine, Create a routine trigger, Manually run a routine y todos los endpoints en Rutinas.

RutinasTrabajoWebhooks