Helper WordPress Plugin 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

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

Enable bot logs

The option allows you to save the history of user interaction with the chatbot during one session. This adds a new menu item “Bot Logs” in the helper settings where all logs can be tracked and read.

End conversation conditions

The toggle allows ending the conversation if the user get the necessary information. It includes setting up additional bot messages and conditions for continuing the conversation.

End conversation conditions menu initial messages
Set end conversation conditions menu initial messages
Set end conversation conditions menu initial messages
Try again messages

Enter bot messages if the user wishes to continue the conversation after the previous bot response.

End conversation messages

Enter bot messages if the user wishes to finish the conversation after the previous bot response.

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
Add initial bot bot messages

Bot behavior

Section for setting bot behavior 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 includes additional configurations like Auto-submit after recognition is finished, selection of icon, color and size for the button.

Speech recognition settings
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

Always opened when button turned off – enable this option to keep the chatbot window always open when float button is turned off.

Chat popup styles

Chat popup styles
Chat popup styles
Trigger the Chat Popup via the custom button or link.

You can add the trigger of the chatbot for any button or link on the site using the class:

mdp-helper-trigger

An example of the custom button trigger:

<button class="mdp-helper-trigger"> Chat bot </button>

An example of the custom link trigger:

<a class="mdp-helper-trigger" href="#"> Chat bot </a>

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.

You can use several API keys from different OpenAI accounts in the plugin, which will be used randomly. This helps to reduce getting Rate limits with a large number of requests.

Add API key
Add API key

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

Each GPT model, provided in the plugin via Helper>AI>Model, has a maximum token limit due to computational constraints. That is, when choosing posts, pages or products in your Prompt type for the bot answers, you should remember that there are limits on the amount of text that can be used by the bot. Otherwise, you will get an error about exceeding the limit. Read more about the limits and how to manage this in the guide.

Select the content type you want to use as context for bot responses. The following Prompt types are available:

Post content

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

Select Post Content
Custom

This type allows you to add custom text in the Prompt field. Write a 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. The option allows you to select only the necessary product attributes that will be taken into account by the bot.

PDF file

This type allows you to use the text from your PDF file as the bot response context.

Notice

The text field to enter the bot’s response if it can`t find the 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(deprecated)
  • text-davinci-002(deprecated)
  • text-ada-001(deprecated)
  • text-babbage-001(deprecated)
  • text-curie-001(deprecated)
  • gpt-3.5-turbo
  • gpt-3.5-turbo-16k
  • gpt-3.5-turbo-1106

Max bot response tokens

Set max completion tokens. Please note that this value is summed with the number of tokens in the Prompt and the sum of these values should not exceed the limits of the model.

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.

Limit user requests

The option allows you to limit the number of user requests from a specific IP. It is useful for saving your budget when using Open AI API.

You can set a certain number of requests for a specific period of time. For example, 10 requests within 3 minutes. If the number of requests is exceeded, the user will receive a message “You exceeded your requests limit...”

Video tutorial on using Openai API and Assistant API in the Helper plugin.

Personalities

The tab settings allow you to add new personalities with assistant bot type and select the required one by default.

To create a new personality with the Open AI Assistant type, you need to create the Assistant in your Open AI account first.

Active personality

Select the personality that will be used for your AI chatbot. By default, one personality is available. If you add new ones, then select the one in this list that you want to apply to your site.

Create a new bot personality

You can change your current personality by changing the name and AI Bot Type. Otherwise, add a new one by clicking on the Add bot personality button and fill all fields.

AI Bot Types:

  • GPT Model – uses all bot settings (Prompt type, Objective, Notice, Model, etc) specified in the Helper>AI tab.
  • Open AI Assistant – uses the assistant settings specified in the Open AI settings.

Once the new personality is created, press Save Changes. After that, you can select it in the Active personality list to apply it to your site.

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.

Acceptance checkbox

The option allows you to enable a checkbox to confirm the user’s acceptance of all conditions for collecting their data. The following settings are available:

  • Do not add – collect data without any confirmation from the user.
  • Show one time and save to localstorage – show the checkbox and save the user confirmation in local storage with key name mdpAcceptedCollectData
  • Show on every new session – show the checkbox with every new user session.

Enable Google Analytics

Option to enable Google Analytics support. It sends generate_lead event with event_label “Helper collect data” to Google Analytics on successful collect data.

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 a question for your Collect data, click the button Remove bot message. Clear the question field before deleting the field.

Bot response messages

Enter a 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 variations for email address requests, the one will be displayed randomly selected.

Bot response messages

Enter a 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 are 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
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
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
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

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.

Was this article helpful to you?