Documentation - OrcaHive

Introduction

In this guide, you'll create your first fully functional AI chatbot from scratch. We'll cover everything from initial setup to deployment on your website.

Prerequisites

Make sure you have an OrcaHive account. If not, sign up here.

Creating Your Bot

Let's start by creating a new chatbot:

Log in to your OrcaHive dashboard
Click the "Create Chatbot" button
Fill in the bot details:
- Bot Name: Give your bot a descriptive name (e.g., "Support Assistant")
- Language: Select your primary language
- Industry: Choose your business category (optional)
Click "Create" to proceed

Adding Training Data

Your bot needs data to learn from. You can add training data in several ways:

Upload Files

Upload documents containing information about your business:

Supported formats: PDF, TXT, DOCX, CSV
File size limit: 10MB per file (Free), Unlimited (Pro)
Best practices: Use well-formatted documents with clear headings

Training Data Tips

Include FAQs, product descriptions, policies, and common customer questions for best results.

Paste Text Directly

You can also paste text directly into the training interface:

Click "Add Text" in the training tab
Paste your content
Add a title for reference
Click "Save"

Website Scraping (Pro)

Pro users can automatically import content from their website:

Enter your website URL
Select pages to scrape
Click "Import Content"

Customizing Appearance

Make your chatbot match your brand:

Choose where the chat widget appears:

Bottom Right (default)
Bottom Left
Top Right
Top Left

Colors & Branding

Customize the visual appearance:

Primary Color: Main theme color
Bot Avatar: Upload a custom icon or use default
Welcome Message: First message users see
Placeholder Text: Input field placeholder

javascript

// Customize widget appearance
orcahive('init', {
  botId: 'your-bot-id',
  position: 'bottom-right',
  primaryColor: '#0066FF',
  welcomeMessage: 'Hi! How can I help you today?',
  placeholder: 'Type your message...'
});

Testing Your Bot

Before going live, thoroughly test your chatbot:

Navigate to the "Test" tab
Start a conversation
Ask various questions related to your training data
Check response accuracy and relevance
Refine training data if needed

Testing Best Practices

Test with questions your actual customers might ask. Include edge cases and unusual queries.

Deploying to Your Website

Once you're satisfied with your bot's performance, deploy it:

Get Embed Code

Go to the "Deploy" tab
Copy the provided JavaScript snippet
Paste it before the closing </body> tag

index.html

html

<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->
  
  <!-- OrcaHive Widget -->
  <script>
    (function(w,d,s,o,f,js,fjs){
      w['OrcaHiveWidget']=o;w[o] = w[o] || function () { (w[o].q = w[o].q || []).push(arguments) };
      js = d.createElement(s), fjs = d.getElementsByTagName(s)[0];
      js.id = o; js.src = f; js.async = 1; fjs.parentNode.insertBefore(js, fjs);
    }(window, document, 'script', 'orcahive', 'https://orcahive.io/widget.js'));
    
    orcahive('init', {
      botId: 'your-bot-id-here'
    });
  </script>
</body>
</html>

Verify Installation

After adding the code:

Save and publish your website changes
Visit your website
Look for the chat widget in the corner
Test a conversation

Congratulations!

Your chatbot is now live and ready to engage with visitors! 🎉

Monitoring Performance

After deployment, monitor your bot's performance:

Analytics Dashboard: View conversation metrics
Chat Logs: Review actual conversations
User Feedback: Collect ratings and feedback
Response Accuracy: Track successful vs. failed responses

Learn more about analytics in our Analytics Guide.

Introduction

In this guide, you'll create your first fully functional AI chatbot from scratch. We'll cover everything from initial setup to deployment on your website.

Prerequisites

Make sure you have an OrcaHive account. If not, sign up here.

Creating Your Bot

Let's start by creating a new chatbot:

Log in to your OrcaHive dashboard
Click the "Create Chatbot" button
Fill in the bot details:
- Bot Name: Give your bot a descriptive name (e.g., "Support Assistant")
- Language: Select your primary language
- Industry: Choose your business category (optional)
Click "Create" to proceed

Adding Training Data

Your bot needs data to learn from. You can add training data in several ways:

Upload Files

Upload documents containing information about your business:

Supported formats: PDF, TXT, DOCX, CSV
File size limit: 10MB per file (Free), Unlimited (Pro)
Best practices: Use well-formatted documents with clear headings

Training Data Tips

Include FAQs, product descriptions, policies, and common customer questions for best results.

Paste Text Directly

You can also paste text directly into the training interface:

Click "Add Text" in the training tab
Paste your content
Add a title for reference
Click "Save"

Website Scraping (Pro)

Pro users can automatically import content from their website:

Enter your website URL
Select pages to scrape
Click "Import Content"

Customizing Appearance

Make your chatbot match your brand:

Choose where the chat widget appears:

Bottom Right (default)
Bottom Left
Top Right
Top Left

Colors & Branding

Customize the visual appearance:

Primary Color: Main theme color
Bot Avatar: Upload a custom icon or use default
Welcome Message: First message users see
Placeholder Text: Input field placeholder

javascript

// Customize widget appearance
orcahive('init', {
  botId: 'your-bot-id',
  position: 'bottom-right',
  primaryColor: '#0066FF',
  welcomeMessage: 'Hi! How can I help you today?',
  placeholder: 'Type your message...'
});

Testing Your Bot

Before going live, thoroughly test your chatbot:

Navigate to the "Test" tab
Start a conversation
Ask various questions related to your training data
Check response accuracy and relevance
Refine training data if needed

Testing Best Practices

Test with questions your actual customers might ask. Include edge cases and unusual queries.

Deploying to Your Website

Once you're satisfied with your bot's performance, deploy it:

Get Embed Code

Go to the "Deploy" tab
Copy the provided JavaScript snippet
Paste it before the closing </body> tag

index.html

html

<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->
  
  <!-- OrcaHive Widget -->
  <script>
    (function(w,d,s,o,f,js,fjs){
      w['OrcaHiveWidget']=o;w[o] = w[o] || function () { (w[o].q = w[o].q || []).push(arguments) };
      js = d.createElement(s), fjs = d.getElementsByTagName(s)[0];
      js.id = o; js.src = f; js.async = 1; fjs.parentNode.insertBefore(js, fjs);
    }(window, document, 'script', 'orcahive', 'https://orcahive.io/widget.js'));
    
    orcahive('init', {
      botId: 'your-bot-id-here'
    });
  </script>
</body>
</html>

Verify Installation

After adding the code:

Save and publish your website changes
Visit your website
Look for the chat widget in the corner
Test a conversation

Congratulations!

Your chatbot is now live and ready to engage with visitors! 🎉

Monitoring Performance

After deployment, monitor your bot's performance:

Analytics Dashboard: View conversation metrics
Chat Logs: Review actual conversations
User Feedback: Collect ratings and feedback
Response Accuracy: Track successful vs. failed responses

Learn more about analytics in our Analytics Guide.

Your First Chatbot

Introduction

Prerequisites

Creating Your Bot

Adding Training Data

Upload Files

Training Data Tips

Paste Text Directly

Website Scraping (Pro)

Customizing Appearance

Widget Position

Colors & Branding

Testing Your Bot

Testing Best Practices

Deploying to Your Website

Get Embed Code

Verify Installation

Congratulations!

Monitoring Performance

Your First Chatbot

Introduction

Prerequisites

Creating Your Bot

Adding Training Data

Upload Files

Training Data Tips

Paste Text Directly

Website Scraping (Pro)

Customizing Appearance

Widget Position

Colors & Branding

Testing Your Bot

Testing Best Practices

Deploying to Your Website

Get Embed Code

Verify Installation

Congratulations!

Monitoring Performance