How to create a story using the Visual Builder

Overview

The Visual Story Builder allows you to design interactive conversation flows.
Each Story represents a chatbot conversation made up of multiple connected blocks, such as text responses, media, forms, and API integrations.

This tool helps you automate structured conversations, capture user input, and guide them through specific actions.

 Purpose of a Story

The purpose of creating a story is to:

• Design an automated chat flow for your bot or assistant.
• Define how the bot responds to user inputs.
• Integrate various functionalities, such as forms, media, AI-based responses, and API data.
• Control the conversation path through conditions and redirects.

Step 1: Go to the Agentic Platform

• Log in to your Agentic/Botsify Dashboard using your credentials.
• Once logged in, you’ll see the main navigation menu on the left-hand side.
   

Step 2: Open the Chatbot Section

• In the left menu, click on “Chatbot” to expand the options.
• Under the Chatbot section, you’ll find multiple features such as Story, AI Assistant, etc.
   

Step 3: Click on “Story”

• Click on the “Story” option under the Chatbot dropdown.
• This will take you to the Stories page, where you can view all your existing stories.
   

Step 4: Click on “Create Story”

• On the top right corner of the page, click on the “+ Create Story” button.
• This opens a new window where you can start building your story.
   

 

A story typically starts with a User Input Block and continues through a series of response and action blocks.

 Basic Flow Structure

Each story flow begins with a User Input Block.
The flow can then branch out depending on what you want to achieve.

Example Flow:

1. User Input (Keyword Group) – defines what triggers this story.
2. Text Response – the bot replies with a message.
3. Media Block – sends an image or video.
4. Form Block – collects user information.
5. Conditional Redirect – decides next steps based on user input or responses.
   
    

 Available Blocks and Their Functions

🗨️ User Input

This block defines how the story is triggered.

• Keyword Group: Starts the story when a user’s message contains certain keywords.
• Phrase: Responds to exact phrases.
• Type Anything: Captures any input to process next.

Use this as your starting point in every story.

💬 Text Response

Displays a message from the bot to the user.

You can:

• Write static text responses.
• Use variables to personalize messages.

• Add multiple text blocks to guide the flow. 

  
  

🖼️ Media Block

Allows you to send images, videos, GIFs, or other media.

Useful for:

• Product demos or visuals.
• Banners and tutorials.
• Making your conversation more engaging.
   

🔗 Link Story

Connects one story to another.

• Helps you organize large flows into smaller reusable stories.
• Use it to move users between topics or service sections.
   

👤 Notify Human Agent

Transfers the conversation to a live human agent.

• Ideal for escalations, complaints, or complex issues.
• You can define which agent or team gets notified.
   

📋 Conversational Form

Collects structured input from users (like name, email, feedback, etc.).

• Supports multiple fields (text, number, dropdown, etc.).
• Automatically validates entries.
   

⏳ Typing Delay

Adds a small delay between messages to simulate human-like typing.

• Makes the conversation feel more natural.
   

🔀 Conditional Redirect

Allows logic-based branching in the conversation.

• Define conditions based on user input, variable values, or API data.
• Redirect users to the appropriate blocks or stories.
   

Example:

IF user_input = "Order" → Go to Order Story  

ELSE → Go to Help Story
 

🌐 JSON API Integration

Connects your story to an external API to fetch or send data.

• Example: Fetch order status, verify OTP, get user info, etc.
• You can pass variables and use the API response in later blocks.
   

🤖 AI Assistant Block

Leverages AI to generate intelligent, dynamic responses.

• Can handle open-ended questions.
• Optionally combine with keyword-based flow for hybrid responses.
   

5. Saving and Testing the Story

After designing your flow:

1. Click Save (top left).
2. Test the story in your chat widget or bot interface.
3. Adjust connections and logic as needed.