Workflow Triggers

Triggers are how workflows are launched in Victoria AI. They determine when and how your workflow should run, making them an essential component of building automations.

There are currently three types of triggers available in Victoria AI:

1. Chat Triggers

Every active workflow automatically comes with a Chat trigger. This means that you can initiate your workflow simply by chatting with Victoria. This is a flexible and fast way to run workflows whenever you need them.

Key points about Chat Triggers:

• Always available for every active workflow.
• Triggered manually via conversation with Victoria.
• Useful for on-demand actions and one-off processes.

2. Schedule Triggers

Schedule triggers allow you to run workflows automatically on a recurring basis. These are perfect for automations that need to happen at specific times or intervals.

Supported scheduling options include:

• Hourly
• Daily
• Weekdays
• At a certain time of day
• Monthly

When creating a schedule trigger, keep in mind:

• The workflow must be active for scheduled triggers to run. If it is paused or inactive, scheduled runs will not execute.
• If a workflow runs into an error or if the account runs out of tokens, the workflow and the associated trigger will be automatically paused. You can reactivate them via the dashboard after resolving the issue.

Tip: Always make sure your workflow is tested and active before relying on schedule triggers for critical automations.

3. Webhook Triggers

Webhook triggers let you start a workflow by sending an HTTP POST request to a unique URL. This makes it easy to connect external tools, platforms, or custom systems to your Victoria workflows.

How it works:

• Each webhook trigger comes with a unique endpoint you can send data to.
• The request payload is automatically passed into your workflow as input data.
• This is ideal for event-driven automations like form submissions, CRM updates, or webhook events from other apps.

Optional: Callback URL

You can optionally provide a callback URL when setting up the webhook trigger. If provided, Victoria will execute the workflow in the background and send the final result back to your system via an HTTP POST to the callback URL.

If no callback URL is provided, the system will process the workflow immediately and return the result directly in the webhook response.

Benefits of using a callback URL:

• Ensures fast response times for incoming webhooks.
• Supports long-running workflows without timing out.
• Allows your system to receive and handle the final result asynchronously.

Tip: If you’re integrating with platforms that have strict timeout limits on webhooks (like Slack or Stripe), using a callback URL is highly recommended.

By combining Chat, Schedule, and Webhook triggers, you can design workflows that respond to user input, run automatically, or react to external systems — all within Victoria AI.