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.

Fresh Start Option:

Enable Fresh Start to treat every message as an independent conversation. When enabled:

  • Each user input starts a brand new conversation
  • No context or history from previous messages
  • Perfect for flows where each query should be handled independently

When to Enable:

  • FAQ bots where each question is standalone
  • Simple command-based agents
  • Scenarios where conversation history might cause confusion

When to Disable:

  • Multi-turn conversations that require context
  • Customer support with ongoing threads
  • Agents that need to reference earlier messages
tip

Toggle Fresh Start in the Trigger Settings panel when Chat trigger is selected.

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 customizable chat widget for embedding on websites.

Configuration:

Click Configure Widget in the Embed trigger settings to access the full customization panel.

Appearance​

Theme
Choose Light or Dark mode to match your website design. Dark theme is the default and recommended for most use cases.

Accent Color
Select a brand color for buttons, links, and active elements. Displays as a hex code (e.g., #0066FF).

Avatar URL
Provide a direct link to your bot's avatar image. This appears next to bot messages in the chat.

Border Radius
Adjust the slider to control corner rounding (measured in px). Higher values create more rounded edges.

Content​

Header Title
The name displayed at the top of the chat widget (e.g., "Support Assistant" or "BMS Assist").

Input Placeholder
The hint text shown in the message input field (e.g., "Ask BMS Assist about our services...").

Welcome Message
An automatic greeting sent when a new session starts. Use this to introduce the bot's capabilities or provide instructions.

tip

The welcome message appears as soon as the widget opens, helping users understand how to interact with your agent.

Widget Size​

Width & Height
Set dimensions in pixels (px) or percentage (%).

  • Pixels: Fixed size (e.g., 400px)
  • Percentage: Responsive sizing based on screen width (e.g., 80% for mobile-friendly layouts)
info

Use percentage values for responsive designs that adapt to different screen sizes.

Widget Positioning​

Minimized vs. Open
Configure how the widget appears in both its collapsed (minimized) and expanded (open) states.

Alignment
Choose where the widget appears on the screen (e.g., Bottom Right, Bottom Left, Top Right).

Side Offset
Distance from the side edge of the screen (measured in px). Adjust the slider to fine-tune horizontal placement.

Bottom Offset
Distance from the bottom edge of the screen (measured in px). Adjust the slider for vertical positioning.

Behavior​

Open by default
Toggle this to make the widget appear expanded when the page loads. If disabled, users must click to open it.

Auto-open after delay
Set a timer (in seconds) to automatically open the widget after the page loads. Set to 0 to disable.

Use Case

Auto-open with a 5-second delay can engage visitors who might not notice the minimized widget.

Show Suggested Questions
Display clickable question chips when the widget opens to help users start the conversation.

  • Enable Toggle: Turn on "Show Suggested Questions" to activate this feature
  • Add Questions: Type questions in the input field and press Enter (max 4 questions)
  • Remove Questions: Click the X button next to any question to delete it
  • Examples: "How are you?", "Pricing?", "Contact support"

Best For: Guiding users who may not know what to ask, showcasing bot capabilities, or providing quick access to common queries.

info

Suggested questions appear as blue chips below the welcome message. Users can click them to instantly send that message.

Show PDF Citations
Display document sources when the agent answers using PDF files from the Knowledge Base.

  • Toggle: Off by default
  • When enabled: Shows PDF filename and page number below bot responses
  • Citation format: File name + "Page X"

Note: URL citations are always shown by default and cannot be disabled. This toggle specifically controls PDF document citations.

Best For: Compliance scenarios, research bots, or HR assistants where users need to verify the source of information.

info

Citations appear under "Answer based on the following sources" with clickable source cards showing the document name and page number.

Show "Powered by" branding
Toggle this to display or hide the attribution line in the widget footer.

Integration​

Direct Chat Link
A standalone URL for your bot that opens in a full browser tab. Share this link directly or use it for testing.

Embed Code (Script Tag)
Copy the provided <script> tag and paste it into your website's HTML to embed the widget.

<script src="https://agent.bossstudio.tv/embed.js" data-key="your_key"></script>

Regenerate Key
If your embed URL or script tag is compromised, click Regenerate Key to create a new secure link. This invalidates the old URL.

Session Management​

Maintain user conversation history by passing a unique userId.

In Script Tag:

<script src="https://agent.bossstudio.tv/embed.js" data-key="your_key" data-user-id="USER_123"></script>

In URL:

https://agent.bossstudio.tv/embed/ifr_key?userId=user123

Best For: Returning users, authenticated sessions, or personalized experiences.

Preview Button

Click Preview next to the Embed Code to see how your widget looks before deploying it live.

How to Use
  1. Configure the widget appearance above
  2. Save your flow to apply the changes
  3. Copy the embed code and paste into your website

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