Create a Chatbot in RhinoAgents¶

This guide explains how to create, configure, customize, test, and deploy a chatbot in RhinoAgents using the prompt-based workflow builder.

By the end of this guide, you will have a fully working, branded chatbot connected to your integrations (such as Shopify), tested using the preview tools, and embedded into your website.

Step 1: Create a Chatbot Using a Prompt¶

RhinoAgents allows you to create chatbots using simple natural language prompts. This removes the need to manually design workflows from scratch.

Steps¶

Log in to the RhinoAgents Customer Dashboard
Locate the chatbot creation input box
Describe what you want your chatbot to do

Example Prompt¶

Create a chatbot for my Shopify store to get order status,
list products, and answer customer questions.

Click Create

What Happens Automatically¶

RhinoAgents will: - Create a new chatbot agent - Generate a complete workflow - Add default trigger and processing nodes - Prepare integration placeholders (Shopify, RAG, AI services)

This allows you to move quickly from idea to implementation.

Step 2: Review the Generated Workflow¶

After the chatbot is created, you will be redirected to the Workflow Editor. The workflow visually represents how messages flow through the system.

Typical Workflow Structure¶

Trigger Node: Activated when a user sends a message
Intent Classification / RAG Node: Understands user intent and extracts information
AI or LangChain Nodes: Generate intelligent responses
Integration Nodes: Fetch data from Shopify or other systems
Response Node: Sends the final reply back to the user

You can zoom, rearrange nodes, and follow the message path visually.

Step 3: Configure Nodes¶

Open the Nodes tab to customize chatbot behavior.

Common Node Types¶

Trigger: Entry point for every conversation
RAG Service: Uses your knowledge base to answer questions
LangChain / AI Nodes: Generate conversational responses
Integration Nodes: Retrieve real-time data (orders, products)
Socket / Response Node: Sends messages back to the chat UI

What You Can Do¶

Edit node settings
Define conditions and rules
Add or remove nodes
Connect nodes to control execution flow

This gives full control over chatbot logic without writing code.

Step 4: Configure Integrations¶

Go to the Integrations tab to connect external systems.

4.1 Shopify Integration¶

Select Shopify
Enter required credentials:
Shopify Store URL
API Key or Access Token
Save the configuration

Once connected, the chatbot can fetch order statuses, list products, and answer store-specific questions.

4.2 RAG (Knowledge Base) Integration¶

RAG allows the chatbot to answer questions from your own documents.

Open the RAG / Knowledge Base section
Upload files (CSV, PDF, TXT)
Link uploaded files to the workflow

The chatbot will now use your content to generate accurate answers.

Step 5: Customize Chatbot Settings & Appearance¶

You can fully customize how your chatbot looks and behaves to match your brand identity. Modification of the agent details is done through the Agent Config and Preview tabs.

Edit Chatbot Details (Name, Image, Languages)¶

To update core chatbot settings, navigate to the Agent Config tab.

Rename AI Chatbot: Locate the Agent Name field and enter your desired custom name.
Add Languages: In the Languages section, select multiple supported languages (e.g., English, French, German) from the dropdown.
Update Chatbot Image: Under the Agent Image section, click Upload to provide a custom avatar or company logo (Max 5MB).
Click the Update Agent button to save changes.

Change Chatbot Colors¶

To align the chatbot interface with your brand colors, navigate to the Preview tab.

Click the Customize button in the top right corner.
The Customize Chatbot modal will appear.
Under the Colors section, you can modify specific elements:
Header Background: Primary color for the chatbot header.
Header Text: Text color in the header.
Chat Background: Background color of the chat area.
User Message: Background color for user messages.
Select a color or enter a specific HEX code.
Click Save Customization to apply the new theme to your widget.

Step 6: Test the Chatbot Using Preview Mode¶

Testing is done from the Preview tab.

Available Preview Options¶

Simulator: Test conversations directly inside the dashboard
Public Chatbot: Generate a public chat link
Live Mode: Test real-time responses

What to Test¶

Order status queries
Product-related questions
Knowledge base questions
Edge cases and invalid inputs

Use the Logs tab to debug issues if responses are incorrect.

Step 7: Generate Public Chat Link and QR Code¶

Under Preview → Public Chatbot:

A public chat URL is generated automatically
A QR code is created for instant access

Use these to share the bot quickly or test on mobile devices without needing to embed it.

Step 8: Embed the Chatbot on Your Website¶

To add the chatbot directly to your website, use the Embed option. Navigate to Preview → Embed.

You will see an embed code similar to the example below:

<!-- Load Socket.io library -->
<script src="https://cdn.socket.io/4.5.4/socket.io.min.js"></script>

<script>
  class ChatbotWidget {
    constructor(options = {}) {
      this.options = {
        workflowId: 'YOUR_WORKFLOW_ID',
        agentId: 'YOUR_AGENT_ID',
        customerId: 'YOUR_CUSTOMER_ID',
        botType: 'sales',
        agentName: 'RhinoBot',
        width: '400px',
        height: '600px',
        position: { bottom: '20px', right: '20px' },
        containerId: 'chatbot-widget'
      };
    }
  }

  // Initialize chatbot widget
  new ChatbotWidget();
</script>