External Triggers

External triggers start an orchestration from something outside the agent chat: a third-party app event, a schedule, or a webhook once webhooks are available.

What triggers are for

Use triggers when work should begin automatically. A new lead, ticket, meeting, form submission, or scheduled check can fire the orchestration and send work to one or more agents.

Trigger types

• Third-party app: Fire from an app event through a connected account.
• Schedule: Fire from a cron schedule or natural-language schedule.
• Webhook: Receive direct webhook events once this trigger type is available.

Best practices

• Wire each trigger to the agent that should handle the first step.
• Keep trigger payloads small and include only what downstream agents need.
• Remember that schedule triggers run in UTC.
• Test with a low-risk event before activating a production path.