← Back to Customization Instructions en français

How to Use the Chatbot Avatar Plugin Service

This service allows you to generate a custom WordPress AI chatbot avatar plugin tailored to your needs. You can personalize the plugin by setting up your Knowledge Base, Predefined Questions, and selecting custom avatars.

▶ Watch Tutorial: Full Workflow Demonstration

Prerequisites: Retrieving Your API Keys

  1. OpenAI API Key:

    Visit the OpenAI API Keys page. Sign in or create an account and generate a new API key. Copy the API key string.

    ▶ Watch Tutorial: How to Get Your OpenAI API Key
  2. Google Cloud Platform Service Account Credentials:

    Go to the Google Cloud Console and create (or select) a project.

    • Enable the Cloud Text-to-Speech API and the Cloud Translation API in the API Library.
    • Navigate to IAM & Admin → Service Accounts and create a new service account, granting it the required permissions.
    • Create and download a JSON key for the service account.
    ▶ Watch Tutorial: How to Get Your GCP Service Account Credentials

    You will upload this JSON file when generating your plugin.

Steps to Get Started

1. Enter Your Content
  • Fill in the "Knowledge Base" field with details about your business or organization.
  • Add one or more Predefined Question-Answer pairs in the provided area.
2. Select or Upload Avatars
  • Select a Speaking Avatar (shown when the chatbot is speaking) and an Idle Avatar (shown when the chatbot is waiting) from the predefined options or upload your own custom images.
3. Input Your API Keys
  • Enter your OpenAI API key in the provided field.
  • Upload your GCP Service Account Credentials JSON key file.
4. Customize Appearance
  • Set your preferred Primary and Secondary colors for the plugin style.
5. Owner Email
  • Provide your email address so that you can receive updates from users interacting with your chatbot.
6. Plugin Generation
  • Click "Generate Chatbot Plugin" to create your custom plugin. A chatbot.zip file will be created for you to download.

Adding the Plugin to Your WordPress Site

  1. Log in to your WordPress admin dashboard.
  2. Navigate to Plugins > Add New and click on the Upload Plugin button.
  3. Select the chatbot.zip file you downloaded and click Install Now.
  4. Once installed, click Activate Plugin.
  5. To display the chatbot, add the shortcode [chatbot_avatar language="en-US"] (or [chatbot_avatar language="fr-CA"] for Canadian French) to any page or post.

Example Workflow

For instance, if you operate a real estate business, you might enter the following in your Knowledge Base: 

You are a helpful assistant for a real estate business called My Real Estate.
Currently, we operate in the downtown area and have several properties available.

And define a FAQ pair such as:

Question: What are your business hours?
Answer: We are open from 9 AM to 5 PM, Monday through Friday.

Follow the steps above to generate your custom plugin and integrate it into your WordPress site.

Back to Customization
↑