# Helper - ChatBot WordPress Plugin

- created: 08/07/2023
- latest update: 08/07/2023
- by: merkulove
- https://helper.merkulov.design/

WordPress plugins Documentation

### Overview

The Helper is a fast and easy-to-add Chatbot WordPress plugin that supports regular and AI Bot types. The AI Chatbot is powered by OpenAI GPT-3 (ChatGPT) and easily integrates into your site without any special technical knowledge. It can efficiently handle questions related directly to your website content or products, provide personalized responses, and resolve common issues, reducing the need for human intervention. This leads to enhanced customer satisfaction and a positive user experience.

The chatbot includes different methods of user interaction like finding answers to frequently asked questions that you prepare in advance in the plugin settings. Another option is a collection of users' data for further communication, order, analytics and insights, etc. Also, common email submission is also included. You can use only the bot functions required for you or all available ones including the Artificial Intelligence feature to provide your visitors with a successful experience.

Powered by OpenAI GPT-3(ChatGPT)
Focus on the Context of your site
Modern User Interface
Bot Speaking by WebSpeech API
Native Valid JavaScript
Supports Speech Recognition
8 Bot Position and Shortcode Integration
Suitable for all kinds of Layouts and Templates
Fully Compatible with WordPress 6+
Works Great with all popular themes
Completely Cross-Browser Support

### A lot of useful functions and settings

Personalization and context-awareness: GPT-3-powered chatbots can analyze user input and generate responses that are contextually relevant and personalized.

Customizable bot objective: you can specify how the bot should answer depending on your purpose and specific needs. This allows you to adapt its behavior, manners and focus on specific context according to unique requirements. The bot can generate responses only for specified content (posts, pages, products) or without any restrictions.

Different bot features combination: there are included FAQ block, data collection form, email sending form and AI bot. You can use these features together or all separately easily managing them in the plugin setting.

Speech recognition: includes a voice input feature instead of manual typing. This can greatly improve the user experience, especially for individuals with limited typing skills or mobility impairments. Users can simply speak their responses, making the process faster and more accessible.

Speech syntheses: the bot can convert messages to speech and speak to the user. The Text to Speech function is based on WebSpeech API and included 40+ Languages and more than 160 voices.

Sale assistance: the chatbot with artificial intelligence can act as a virtual sales assistant in your WooCommece store, engaging with potential customers, and guiding them through the sales process. By providing product recommendations, answering queries and help convert leads into sales.

24/7 availability: unlike human agents who have limited working hours, AI chatbots are available 24/7, ensuring continuous support and assistance for customers across different time zones. This accessibility improves customer satisfaction, especially for global businesses or organizations serving diverse audiences.

Multiple communication channels: the Helper plugin provides the ability to add different communication methods such as mail, call, and social networks to quickly reach human support. It can combine the benefits of automated assistance with the strengths of human interaction, leading to improved customer satisfaction, higher engagement, and better overall customer experiences.

Multilingual: AI Chatbot can understand different languages and give the answer in the appropriate language.

Flexible chatbot style settings: each element of the chatbot window as well as the open button can be customized in accordance with your website styles or individual wishes. You can manage colors, sizes, backgrounds, border,s and a lot of other things. It also includes 8 preset bot display positions and supports shortcode to place the bot anywhere on the page.

Сross-browser compatibility: the ChatBot WordPress Plugin is compatible with all major web browsers, including Chrome, Firefox, Opera, and Safari. Users will have an exceptional browsing experience regardless of the browser they use. The bot can be beneficial for various types of websites, such as blogs, portfolios, corporate websites, eCommerce projects, creative agencies, real estate listings, personal CVs, restaurants, or retail companies.

### Features of the ChatBot WordPress Plugin

- Powered by OpenAI
- Customizable bot objective
- Contextual understanding based on site posts, products, or specific text
- Flexible settings for generating responses
- The Bot speaking by WebSpeech API
- Includes 40+ Languages and more than 160 voices for text-to-speech
- Included FAQ use case
- Adaptive Learning
- Integration with other communication methods
- Simulates humanoid behavior in chat
- Can collect user data
- Use of artificial intelligence and machine learning
- Variable and customizable greeting phrases
- Customizable sounds for sending and receiving messages
- 8 predefined Bot button positions
- Support Bot shortcode to use anywhere
- Saving the last response of the bot
- Flexible chat style settings
- Possibility to use a bot for survey forms
- The capability to employ a bot for gathering data to build mailing lists
- Focus on the context of your site
- The bot with unique behavior for each site
- Can answer questions about your WooCommerce products
- Translated into 10 most popular languages
- Includes limited speech recognition
- All major browsers supported Chrome, Firefox, Safari, Opera, Edge, and Internet Explorer
- Compatible with WooCommerce
- 100% SEO friendly
- Easy to use and customize
- Installation Guide
- Detailed Users Manual
- Huge Customization Capabilities
- Six months Included Support for CodeCanyon buyers

Learn a little more about what the plugin can do and how to configure it from the Online Documentation.

### Installing

Installing the WordPress plugin is quick and straightforward. After you have downloaded the archive with the plugin, you will see the file with the plugin inside. Unzipped purchased the product you will see inside the archive with the plugin pluginname.zip There are two ways to install it:

## Installation of the Plugin through the WordPress Admin panel ( Recommended for most users )

###### STEP 1

First of all, open WordPress admin area login page and login in into WordPress as Admin. To do this visit http://yoursitename/wp-admin

###### STEP 2

Go to Plugins > Add New

Add New Plugin to WordPress

###### STEP 3

Click Upload Plugin Button

Upload New Plugin to WordPress

###### STEP 5

Choose archive with Plugin and press Install Now Button

###### STEP 6

After Installing go back to the Plugins page and click Activate below plugin title

Activate Installed Plugin

## Installation the plugin through FTP or build-in File manager

###### STEP 1

Use Login and Password to connect to your web-server via FTP or use your hosting file manager.

###### STEP 2

Upload archive with plugin to /wp-content/plugins

###### STEP 3

On next step Unzip the archive with the plugin

###### STEP 4

Installing WordPress Plugin is almost finished. Go to the Plugins page and click Activate below plugin title. You can find out your username and password on the website of your hosting provider.

Activate Installed Plugin

After installing and activating the plugin, you can go to settings of the Plugin. Also, you can read more helpful articles about WordPress Themes and WordPress Plugins.

### Settings

The Helper WordPress Plugin includes different methods of user interaction like finding answers to frequently asked questions that you prepare in advance in the plugin settings. Another option is a collection of users' data for further communication, order, analytics and insights, etc. Also, common email submission is also included

To start setting up the Chatbot plugin open the Helper>Settings in your WordPress Dashboard sidebar menu.

Helper menu item

There are multiple tabs responsible for various groups of plugin settings.

- General
- Bot behavior
- Chat Popup
- AI
- FAQ
- Collect data
- Get emails
- Float Button
- Chat Header
- Toolbar
- Chat Container
- Avatar
- Chat Bubble
- Response Form
- Chat Footer
- Custom CSS
- Assignments
- Migration
- Status
- Updates

## General

The General tab includes selecting bot features, positions, adding sounds for receiving and sending messages, and creating bot responses.

### Bot features

Choose the features you want to use in the chatbot. When adding each of the features, a new tab will be added with additional settings for the selected feature.

###### FAQ

A FAQ (Frequently Asked Questions) block in a chatbot can be used to provide quick and easy access to commonly asked questions and their corresponding answers. It serves as a way to address common inquiries or concerns without the need for extensive back-and-forth conversations.

When adding the bot feature, a new FAQ tab with settings appears where you can enter questions and answers and also sort them into categories.

FAQ block in the chatbot

###### Collect user data

Collecting data from a form in a chatbot serves various purposes depending on your specific needs and objectives. Here are a few common reasons for using a data collection:

- collect data from potential customers, such as their names, email addresses, phone numbers, or other relevant details. This information can be used to follow up with leads and convert them into customers.
- gather information about the user's issue or question before connecting them with a human agent.
- feedback or conduct surveys by presenting users with a series of questions. This data can be used to gather insights about user satisfaction, preferences, or suggestions for improvement.
- If you're hosting an event or webinar, a chatbot can collect participant information, such as names, email addresses, and any specific requirements or preferences.

When adding the bot feature, a new Collect data tab with settings appears where you can enter the bot questions.

###### Get user emails

Email sending form that allows users to reach out with questions, feedback, or inquiries, and provides you with the necessary information to respond effectively.

When adding the bot feature, a new Get emails tab with settings appears where you can enter the bot questions.

###### Open AI

AI chatbots enhance customer experiences and driving efficiency providing humanoid support. You can set the objective, specify context based on which answers will be provided to get the most relevant result.

When adding the bot feature, a new AI tab with settings appears where you can configurate different options.

###### Bot commands

The option adds a button to the toolbar of the chatbot window that calls the available bot commands for easier navigation.

### Bot position

Choose one of the available preset bot display positions: Fixed top left, Fixed top centre, Fixed top right, Fixed left centre, Fixed right centre, Fixed bottom left, Fixed bottom centre, Fixed bottom right or use the Shortcode `[helper]`

### Send message sound/Receive message sound(WAV, MP3, OGG)

The option allowa to add "Send message" and "Receive message" sounds to enhance the user experience and provide auditory feedback for the conversation. Use audio files in the format WAV, MP3, OGG.

Upload "Send message" and "Receive message" sounds

### Bot response messages

Enter welcome bot messages. If you have several initial messages, the one will be displayed randomly selected. Also, enter a message if an error occurs.

Add initial bot bot messages

## Bot behavior

Section for setting bot behave options such as speech recognition, speech syntheses, typing animation, etc

### Speech recognition

Speech recognition in the chatbot based on WebSpeech API allows users to interact with the bot using spoken language instead of typing. It expands accessibility, improves user experiences, and enables more natural and conversational interactions between users and the bot.

The option also include additional configurations like Auto-submit after recognition is finished, selection of icon, color and size for the button.

Speech recognition settings

### Speech syntheses

Speech synthesis based on WebSpeech API, also known as text-to-speech (TTS), allows the bot to convert written text into spoken words.It enhances user experience and accessibility by adding a dynamic and interactive element as well as enables users with visual impairments or reading difficulties to access and interact with the chatbot.

You can view and listen to all available voices by following this link Web Speech API supported voices. The text-to-speech feature support multilingualism.

The maximum length of the text that can be spoken by in each utterance is 32,767 characters.

### Humanoid behavior

This block of settings is responsible for simulating human behavior. You can enable Bot typing animation, Typing animation delay and Bot respond delay.

### Remembrance

This group of settings to save and use the previous experience of interacting with the bot. This allows you to save the last user conversation with the bot for a certain time.

## Chat Popup Settings

A set of settings for style configurations of the chatbot container. You can adjust the width and height of the window, Background color, Border style and color, Border radius, Box shadow, chat appearance animation, etc

Chat popup styles

## Artificial Intelligence Settings

The settings block for AI chat bot integration and configuration powered by OpenAI GPT-3. The section with settings is available when the "Open AI" feature is selected in General>Bot features.

### Open Ai api key

To start work with bot you have to set Open AI API key. For this you should sign up and get it by following link Get API key Do not share your API key with others, or expose it in the browser or other client-side code.

Find the price for using Open AI API in the block InstructGPT models.

Start experimenting with $5 in free credit that can be used during your first 3 months.

### Prompt type

Select the content type you want to use as context for bot responses. Leave this field blank if you don't want to link to your site's content. The following Prompt types are available:

###### Post content

This type allows you to select all or specific posts/pages whose content should be considered for bot responses.

Post id – a post/page identifier that you can find by hovering the post title in the posts list.

How to find the post ID

###### Custom

This type allows you to add custom text in the Prompt field. Write description or documentation about your product, website, service or something else as the context of bot answers.

###### WooCommerce products

This type allows you to use your Woocommerce products as response context. The bot can act as a store assistant as well as provide a link to a specific product that is most suitable for the visitor's requirement

### Notice

The text field to enter the bot's response if it can`t find answer in the specified context(Prompt Type) .

### Objective

The field where you can set the behavior of the bot depending on the specific use case and context. Just describe on the basis of what answers should be provided, the manner of communication and the purpose.

For example "Answer as a virtual seller of goods from the current site" - to interest and involve the client, to offer products in accordance with the requirements. Or "Keep up any customer conversation regardless of the content of the current site" to get an answer to any question.

For multilingual sites, it is recommended to add "Answer in the language in which the question was asked"

### Model

The OpenAI API is powered by a diverse set of models with different capabilities and price points. You can select one of the available models:

- text-davinci-003
- text-davinci-002
- text-ada-001
- text-babbage-001

### Max tokens

Set maximum number of tokens allowed in an input text. Tokens are chunks of text that can range from individual characters to whole words, depending on the language and encoding used.

The "max tokens" setting is used to limit the length of the input text to ensure that it fits within the model's limitations. Each GPT model has a maximum token limit due to computational constraints.

### Temperature

The parameter controls the randomness of the model's output. It influences the diversity and creativity of the generated responses.

Temperature values typically range from 0 to 1, with higher values (e.g., 0.8) producing more diverse and unpredictable responses, and lower values (e.g., 0.2) leading to more focused and deterministic responses.

## FAQ

The section with settings is available when the "FAQ" feature is selected in General>Bot features.

### Button name

Enter the button name that will be displayed in the сhatbot.

### FAQ pagination

The option to enable pagination for the questions and answers. If you have a large list of questions, then they can be divided into pages by specifying how many questions to display per page.

### Add new questions

To add a new question for your FAQ block, click the button Add question/answer

and fill in the following fields:

- Question - enter a question in the text field.
- Bot answer - enter the answer to the question. It can be in text or link format. If you use a single internal link to a page or post, the answer will be displayed in a nicely designed widget with a link.

- Question category - enter a category if you would like to separate questions from different directions. To group certain questions, the category name must be exactly the same.

### Delete question

To delete question for your FAQ block, click the button Remove question/answer. Clear the question field before deleting the field.

### Bot response messages

Enter a bot message that will be displayed before the FAQ block. If you have several messages, the one will be displayed randomly selected. Also, enter a message if an error occurs.

## Collect data

The section with settings is available when the "Collect user data" feature is selected in General>Bot features.

### Button name

Enter the button name that will be displayed in the сhatbot.

### Save to database

Option to save user data received from the chatbot in the database. By default, all data is stored in Helper>User Data.

### Send to email

Option to send user data received from the chat bot to the specified email.

### Add new messages

To add a new message for your Collect data block, click the button Add bot message

and fill in the following fields:

- Field name - enter the field name which will be displayed in the email or in the User data record.
- Field validation - ыelect the type of field validation depending on the required information.
- Bot message - enter a question/message that will be displayed in the chat bot.

### Delete message

To delete question for your Collect data, click the button Remove bot message. Clear the question field before deleting the field.

### Bot response messages

Enter success message after getting all required user data. If you have several messages, the one will be displayed randomly selected. Also, enter a message if an error occurs.

## Get emails

The section with settings is available when the "Get user emails" feature is selected in General>Bot features.

### Button name

Enter the button name that will be displayed in the сhatbot.

### Recipient email

Set recipient email addresses to get the users submitted form. Multiple email addresses can be separated by commas.

### Add new messages

To add a new message for sending email, click the button Add bot message

and fill in the following fields:

- Ask user email - enter a bot message to ask for the user's mail
- Ask user message - enter a bot message to ask for the user's message.

If you have several variation for email address requests, the one will be displayed randomly selected.

### Bot response messages

Enter success message after getting all required user data. If you have several messages, the one will be displayed randomly selected. Also, enter a message if an error occurs.

## Float Button Settings

A set of style settings for the open chatbot button.

### Open Bot button

Settings responsible for the display and styles of the floating button. Here you can set the background color, manage various border settings(style, color, radius), box shadow and more.

Open Bot button settings

### Button icon

The option allows you to enable/disable the display of the button icon as well as manage various settings like choosing the icon, its size and color.

### Button caption

The option allows you to enable/disable the display of the button caption as well as manage various settings like the text changing, its size and color.

## Chat Header settings

Section with style and text settings for the bot window header.

Bot window header

### Chat window header settings

Manage the base styles of the chatbot window header. You can change the Background color, Border style, Border color, Border width and radius, margins and padding.

### Chat window header text settings

The option to enable/disable text in the chatbot window header. This includes a text input field with an editor to add the header content and text style settings such as color and size.

## Toolbar Settings

Toolbar of the chat bot window

### Chat toolbar settings

Manage the base styles of the chatbot window toolbar. You can change the Border style, Border color, Border width and radius, margins and padding.

### Toolbar elements

The block settings allow to manage toolbar links and buttons styles. You can change Icon size and color, Font size and Text color.

Toolbar elements styles

### Chat window close button settings

The option to enable/disable the close button inside the header of the chat window. If the button is disabled, then you can close the popup using the ESC button.

The settings block allows you to select an icon for the close button and also specify Icon size, Icon color, Hover Icon color, margin and padding.

### Bot commands button

The option to enable/disable the Bot commands button inside the header of the chat window.

The block settings allows you to select an icon for the button and enter the button text.

### Mute button

The option to enable/disable the Voice button inside the header of the chat window.The block settings allows you to select an icon for the button and enter the button text.

### Mail button

The option to enable/disable the Mail button inside the header of the chat window. The block settings allows you to select an icon for the button, enter the button text and link.

### Call button

The option to enable/disable the Call button inside the header of the chat window. The block settings allows you to select an icon for the button, enter the button text and link.

### Messenger button

The option to enable/disable the Messenger button(telegram, whatsapp, etc) inside the header of the chat window. The block settings allows you to select an icon for the button, enter the button text and link.

### Social contact button

The option to enable/disable the Social button(facebook, twitter, etc) inside the header of the chat window. The block settings allows you to select an icon for the button, enter the button text and link.

## Chat Container settings

A section with settings for the container and scrollbar of the chat window.

### Chat container styles

The style settings block for the chat container. You can manage Background color, Border style, Border radius, Margin and Padding.

Chat container

### Scrollbar styles

The style settings block for the scrollbar. You can manage Border radius, Scrollbar color, Scrollbar thumb color and Scrollbar thumb hover color.

## Avatar settings

Section for uploading and setting an avatar for the bot and the user.

### Bot avatar/User avatar

The option to enable/disable the avatar. Two types of avatars are available: Icon and Image. Select Hide to disable the avatar.

The settings of the Icon type bot avatar

There are additional style settings for avatars. Customize Avatar size, Avatar gap, Margin, Padding and Border radius.

## Chat Bubble settings

Section for style settings of chat elements such as messages, buttons and container.

Chat bubble elements

### Message Container

Manage the styles of the chat container. You can change the Margins, Padding, Font Size.

### Message upper-line

Chat message top line settings to display message name, time and control button. The settings allow you to enable/disable the display of elements and have additional configuration options.

Chat message top line

### Bot Message/User Message

The settings block allows you to separately configure the message styles of the bot and the user. You can manage Text color, Background color, Border style, Border radius, Message animation(Grow, Shrink, Slide up, Slide down, Fade).

### Action button

The settings block allows you to configure the action buttons styles. You can manage Button width, Text color(hover and regular states), Background color(hover and regular states), Border style, Border radius, Margins and Padding.

## Response Form Settings

Section for style settings of the chat response form.

Chat response form

### Message input field settings

The settings block determines how the input field for sending a message will look like. You can manage Text color(hover and regular states), Background color(hover and regular states), Border style, Border radius, Margins and Padding.

### Send message button settings

The settings block determines how the send message button will look like and work. You can enable/disable the button and customize everything related to styles.

Select the icon for the button, specify caption and placeholder, change Font size and color(hover and regular states), Background color(hover and regular states), Border style, Border radius, Margins and Padding.

## Chat Footer settings

Chat footer

### Chat window footer styles

The settings for managing footer styles in the chat window. The footer contains a send message form and a short text block can be placed.

You can manage Background color, Border style, Border radius, Margins and Padding.

### Footer text description settings

This block settings controls the text that is displayed at the bottom of the chat window. You can enable/disable the text display and customize the text styles. Add you content to the imput field with editor and select the Text color and Font size.

## Save Changes

Do not forget to click Save Changes after changing plugin settings. After clicking this button, the settings will be saved and applied to all pages of the website.