Skip to main content

Triggers

The Trigger is the starting point of every workflow in VibeAgent. It defines how your agent gets activated.

To change the trigger type, click on the Start Node in your canvas to open the Trigger Settings modal.

info

Every workflow must begin with a Start Node that defines these trigger rules.

Available Trigger Types​

VibeAgent supports 5 distinct trigger methods:

1. Conversational Chat​

Starts the flow when a user sends a text message.

Description: The agent receives the text as the user_message variable.

Best For: Conversational agents, customer support bots, and interactive assistants.

Input: The user_message variable becomes available to your agents.

2. Manual Execution​

A manual trigger that executes the flow immediately when you click Run.

Description: Triggers the flow once with no user input.

Best For: One-off tasks (e.g., "Convert this specific PDF to Excel") or testing your logic during development.

3. Scheduled Automation​

Runs your workflow automatically at specified intervals.

Configuration:

  • Frequency: Daily, Weekly, or Custom Interval (e.g., every 30 minutes)
  • Time: Set exact time (e.g., 9:00 AM)
  • Timezone: Critical for accurate scheduling (e.g., Asia/Calcutta)

Best For: News digests, automated reports, data syncing, periodic monitoring.

4. External Webhook​

Generates a unique, public URL that triggers your agent via HTTP requests.

Configuration:

You must Save your flow to generate the Webhook URL.

Usage:

Send a GET request to the provided URL:

https://your-webhook-url.com

Pass input by appending a query parameter:

https://your-webhook-url.com?message=Your+Text+Here

Best For: Integrations with Zapier, Postman, custom backends, or third-party services.

Security: Use Regenerate Key if your URL is compromised. Anyone with the link can trigger the agent.

5. Embeddable Widget​

Provides a pre-built chat widget for embedding on websites.

Configuration:

Appearance:

  • Theme: Light/Dark
  • Accent color
  • Bot avatar

Positioning:

  • Screen position (e.g., Bottom Right)
  • Offset adjustments

Integration:

Copy the provided <script> tag into your website's HTML:

<script src="https://your-widget-url.js"></script>

Direct Link: Share a standalone full-page version of your bot.

Session Management: Maintain user history by passing a unique userId:

<script src="https://your-widget-url.js" data-user-id="USER_123"></script>

Best For: Customer support widgets, internal tool sidebars, public-facing assistants.