v1.0.0

OGA Chatbot Integration Guide

Welcome to OGA's Multi-site Chatbot System! This guide will help you quickly integrate our customized chatbots into your website, regardless of the platform you're using.

Getting Started

1. Register Your Chatbot

To get started, contact our team to register your chatbot. We'll work with you to configure:

  • Chatbot name and personality
  • Avatar and appearance
  • Color scheme and branding
  • Initial welcome messages
  • Lead collection settings

Once your bot is configured, we'll provide you with a unique Bot ID that you'll use to connect your website to your custom chatbot.

2. Add the Chatbot to Your Website

Choose the integration method that matches your website platform:

Standard HTML Website

Add the following code to your website, preferably just before the closing </body> tag:

<!-- OGA Chatbot Integration -->
<script src="https://api.chatbots.ogadesign.com.au/chatbot.js"></script>

<script>
  document.addEventListener('DOMContentLoaded', function() {
    window.Chatbot.init({
      serverUrl: 'https://api.chatbots.ogadesign.com.au',
      botId: 'YOUR_BOT_ID',  // Replace with your provided Bot ID
      autoShowWelcomeBubble: true
    });
  });
</script>

WordPress

Option 1: Using a Plugin
  1. Install and activate the "Header and Footer Scripts" plugin
  2. Go to Settings > Header and Footer Scripts
  3. Paste the integration code from above into the "Footer" section
  4. Save changes
Option 2: Editing Your Theme
  1. Go to Appearance > Theme Editor
  2. Select your theme's footer.php file
  3. Paste the integration code just before the closing </body> tag
  4. Save changes

Shopify

  1. Go to Online Store > Themes
  2. Click "Actions" and then "Edit code"
  3. Open the theme.liquid file
  4. Paste the integration code just before the closing </body> tag
  5. Save changes

Wix

  1. Go to your Wix Editor
  2. Click the "+" button to add elements
  3. Select "More" > "HTML iframe" or "HTML Code"
  4. Paste the integration code
  5. Save and publish your site

Customization Options

You can customize how the chatbot appears and behaves by adding options to the initialization code:

window.Chatbot.init({
  serverUrl: 'https://api.chatbots.ogadesign.com.au',
  botId: 'YOUR_BOT_ID',
  
  // Appearance
  position: 'right',             // 'right' or 'left'
  offset: {bottom: '20px', right: '20px'},
  
  // Behavior
  autoShowWelcomeBubble: true,   // Show a welcome message
  welcomeDelay: 2000,            // Delay in milliseconds
  
  // Advanced settings
  persistChat: true,             // Save chat history in browser
  maxHistory: 50                 // Maximum messages to save
});

Testing Your Chatbot

After adding the integration code to your website:

  1. Refresh your website
  2. Look for the chat icon in the bottom corner
  3. Click the icon to open the chat window
  4. Type a message to start chatting

If the chatbot doesn't appear, check your browser's console for any JavaScript errors and ensure you've used the correct Bot ID.

Managing Your Chatbot

Accessing Chat Transcripts and Leads

When visitors provide their contact information or have meaningful conversations, you'll receive:

  • Email notifications for new leads
  • Full chat transcripts for conversations that result in leads
  • Weekly summary reports of chatbot activity

Updating Your Chatbot

Need to update your chatbot's appearance, behavior, or training data? Contact our support team and we'll help you make the changes.

Frequently Asked Questions

Is the chatbot mobile-friendly?

Yes, our chatbots are fully responsive and work well on mobile devices.

Can I have different chatbots on different pages?

Yes, you can configure the integration code to load different bots based on the page URL.

How does the chatbot handle sensitive information?

Our chatbots are designed to avoid collecting sensitive personal information like credit card numbers or passwords.

Will the chatbot slow down my website?

No, our chatbot script is lightweight (under 100KB) and loads asynchronously, so it won't impact your page loading speed.

Need Help?

If you encounter any issues or have questions about your chatbot integration, our support team is here to help: