Bot System

Overview

The bot system uses a node-based approach where each node represents a specific action or decision point in your conversation flow. You can connect these nodes to create sophisticated automated workflows that respond to user messages, ask questions, make decisions, and connect to external systems.

Key Components

• Agents: Automated bots that handle specific conversation flows
• Nodes: Building blocks that define actions and logic in your workflow
• Connections: Links between nodes that determine the conversation path
• Variables: Store and use data throughout the conversation flow
• Knowledge Bases: Collections of documents your AI agents can access for accurate responses

Getting Started with Agents

Agents are the main container for your bot workflows. Each agent has a specific purpose and can be deployed independently.

Managing Agents

The Agents dashboard allows you to manage all your automated workflows in one place.

From this dashboard, you can:

• View all existing agents
• Monitor the status of each agent (published/draft)
• See active sessions and deployment dates
• Create new agents
• Filter agents by status

Creating a New Agent

To create a new agent:

1. Click the "New Agent" button in the top right of the Agents dashboard
2. Give your agent a name and description
3. Design your conversation flow using nodes
4. Save your draft or deploy immediately

Node Types

The bot system includes several node types, each serving a specific purpose in your conversation flow:

Knowledge Base

A key feature of the Blueticks bot system is the ability to integrate knowledge bases with your agents:

• Create comprehensive knowledge bases from your business documents
• Connect knowledge bases to Agent nodes for accurate, information-rich responses
• Automate customer support with AI agents that access your documentation

Learn more about Knowledge Base functionality.

Building a Bot Flow

Basic Workflow

1. Start with a Trigger node to define when your bot activates
2. Add Message nodes for sending information
3. Use Question nodes to collect user inputs
4. Implement Condition nodes to create branching logic
5. Connect to external services with Webhook nodes
6. For autonomous conversations, add Agent nodes as endpoints in your flow

Node Connection Types

Most nodes connect to subsequent nodes to create a flow:

• Standard nodes (Message, Question, Condition, Webhook, LLM): Connect to other nodes
• Agent nodes: Operate autonomously and don't connect to other nodes, acting as endpoints in your flow

Best Practices

• Keep it conversational: Design your bot to feel natural and human-like
• Use clear questions: Make sure users understand what information you're requesting
• Provide guidance: Use message nodes to explain the purpose of your bot
• Plan for errors: Create fallback paths for unexpected user responses
• Test thoroughly: Use the testing features to ensure your bot works as expected

Example Bot Flows

Customer Support Bot

A comprehensive customer support bot might have this structure:

• Trigger: Activated when a customer messages you
• Message: Welcome message explaining the bot's purpose
• Question: Ask what the customer needs help with (with predefined options)
• Condition: Route to different flows based on the customer's selection
• Agent: For complex questions, deploy an autonomous AI agent with access to your knowledge base (this is a flow endpoint)
• For simple questions, use a Message node to provide standard responses

Lead Generation Bot

A lead generation bot might look like:

• Trigger: Activated when a potential customer messages you
• Message: Introduction and value proposition
• Question: Ask qualifying questions about their needs
• LLM: Analyze responses to score the lead
• Webhook: Record lead information in your CRM
• Condition: Determine if the lead is qualified based on the LLM output
• Message: Schedule a follow-up or provide additional information

AI Support Agent: A Complete Implementation

The AI Support Agent is a practical implementation of the Bot System that showcases how to build a powerful autonomous support assistant. This implementation:

• Provides 24/7 automated customer support through WhatsApp
• Uses the Knowledge Base and Agent node to deliver accurate, helpful responses
• Handles complex customer inquiries without human intervention
• Seamlessly integrates with your existing support documentation

Key components of the AI Support Agent implementation:

1. A knowledge base with your support documentation
2. An Agent node with the Knowledge Base tool enabled
3. Custom system prompts optimized for customer support
4. WhatsApp integration for convenient customer access

To learn how to implement your own AI Support Agent, visit the AI Support Agent guide.

Advanced Features

Variables

Variables allow you to store and use information throughout the conversation:

• Created automatically when using Question nodes
• Referenced using double curly braces: {{variable_name}}
• Available in Message text, Webhook data, and Condition logic

Flow Testing

Before deploying your bot:

• Use the built-in testing features to simulate conversations
• Test each path in your flow
• Verify that variables are correctly stored and used
• Check webhook connections

Deploying and Managing Bots

Once you've built your bot flow:

1. Click "Save Draft" to store your changes without activating the bot
2. Click "Deploy" to make your bot live and available to users
3. Monitor your bot's performance from the Agents dashboard
4. Make adjustments as needed based on user interactions

Your bot will now be active and ready to handle conversations according to your designed flow.

Conclusion

The Blueticks bot system provides a powerful yet intuitive way to create automated conversation flows for WhatsApp. By combining different node types and following best practices, you can create sophisticated bots that enhance your messaging experience and save time on repetitive tasks.