docs

Triggers & automation

Scheduled triggers

Wake an agent on a timer to run a prompt or fire a tool.

What it's for

A scheduled trigger wakes the agent on a timer, without any customer message involved — useful for periodic checks, digests, or automated actions that should happen on a schedule rather than in response to a conversation.

Setting the schedule

Scheduling uses presets, not raw cron expressions:

  • Every N minutes/hours, or
  • Daily at HH:MM, evaluated in your browser's detected timezone.

Choosing an action

  • Run a prompt — free text, delivered either:
    • Log to dashboard — the result is recorded for you to review, with no message sent anywhere, or
    • Send to a channel — delivered to a single Telegram or WhatsApp recipient you control (a chat ID or number — think an internal ops channel, not a broadcast to customers).
  • Run a tool — pick an existing tool and supply JSON arguments. If the tool mutates data, the form warns you explicitly, since it will run automatically on every fire with no confirmation step — double-check the arguments before saving a scheduled trigger tied to a write tool.

Monitoring

A scheduled trigger's detail view shows its next scheduled run, its last run, and its last error if one occurred — check here first if a trigger doesn't seem to be firing.