AIKnowledge Articles

How do I export my knowledge base to Excel?

You can export the content of your knowledge base to an Excel file that contains details like the ID, the creation date, the intent and the answer of the article and the labels assigned to it.

To export your knowledge base to an Excel spreadsheet, please follow these steps:

  1. Log in to your account and navigate to Knowledge > All Articles.
  2. Choose (More).
  3. Select Export Knowledge Base and then Office 2007+ in the drop-down that appears.

    The export file contains the original IDs of the articles. This way, links to other articles work the same way as in the original knowledge base.

    Note: You can export a maximum of 5000 articles with this option.

For more complex exports, you must use our Export knowledge base API.

How do I start creating my Knowledge Base ?

You can import an existing FAQ from a website, create articles manually or upload articles in a batch to fill your knowledge base with content.

You can populate the knowledge base software in 3 different ways.

Importing FAQ from a Website

You can create an instant Knowledge Base by importing an existing FAQ. The Import FAQ tool enables you to import an entire existing FAQ page into the Bold360 AI knowledge base.

  1. Go to Knowledge > Import FAQ.

    Result: The Import FAQ tab is displayed.

  2. In the Enter your FAQ URL field, enter the address (URL) of the FAQ that you want to import.
  3. In the Context section, specify the page type. This can be an internal knowledge base page for your support staff to use, or a public FAQ page.
  4. In the Product ID field, enter the name of the product for this Knowledge Base.You may have more than one product, each of which requires its own Knowledge Base.

Adding new answers manually

There is no need to put a lot of effort in collecting questions for the initial knowledge base, since Bold360 AI will learn new questions from your customer inquiries and new answers from your representatives.

How can I add a new article to my Knowledge Base?

Upload via an Excel sheet

We can upload articles via an Excel file directly into your knowledge base in Bold360 AI.

The Excel file must be Excel 2003-2007 Format.

How to import multiple articles in a batch with the API

For more information regarding uploading the articles via an Excel file, contact your Customer Success Manager, or contact our support.

How do I add another knowledge base?

Learn what to consider before adding a new knowledge base.

When you use a single Knowledge Base for multiple websites

Bold360 AI can support multiple websites from a single knowledge base.

If you have similar content with some modifications based on different categories or websites, you shouldn't create another knowledge base but rather use just one knowledge base with contextual answers. Web visitors can ask the same question, and get different answers based on any differentiating information you have on a customer such as the product or page they're currently looking at. See What are Bold360 AI contextual answers? to learn more.

When you have multiple Knowledge Bases

It is recommended to have separate knowledge bases for completely different content, for example, for internal and external use, completely different websites, a dedicated knowledge base per language and so on.

If you'd like to have an additional knowledge base, contact your Customer Success Manger.

Knowledge Base Labels

Knowledge base labels are categories you can use to organize content in the knowledge base or in the support center.

Knowledge Base Labels are categories that you assigned to articles to make organization of your Support Center easier and more efficient. You can arrange labels in a hierarchy to define how your Support Center is displayed. Labels also make it easier for you to search for specific topics and related answers.

Tip: Looking for information regarding Ticket Labels? See How do I assign a label to a Ticket?

Creating a Label

  1. Go to Knowledge > All Articles and click the Label icon.
  2. Click Create Label.
  3. The Content Labels window is displayed, where you can add, remove, edit and sort labels.
  4. Under Label Name, give your Knowledge Base Label an appropriate name and then select a color for your label.
  5. Save your changes. The label is displayed in the list of Knowledge Base Labels, and is displayed next to any article to which it is assigned.

Categorizing Knowledge Base Answers Using Labels

Categorizing Knowledge Base answers mean that you can easily organize your support page into groups of related topics for easy browsing of your customers.

  1. Go to Knowledge > All Articles, and select the article(s) to be categorized.
  2. Click the Label icon.
  3. Choose the relevant label to assign it to the article.

Categorizing Multiple Labels at Once

  1. On the Knowledge > Articles page, select the check box of an article (or articles).
  2. Click the Label icon () in the toolbar.
  3. Click Select multiple....
  4. Select labels and click Apply.

How to use the knowledge base launchpad

Use the knowledge base launchpad to create a knowledge base quickly and easily.

Note: The knowledge base launchpad is not available by default, it must be enabled for the knowledge base on account level. For more information contact your Customer Success Manager.
  1. In the AI Console, go to Knowledge > Launchpad.
  2. Select one of the predefined packages depending on your business needs.

    Result: Once you select a package, a list of articles appears.

  3. Review and modify the articles as required.

    You have the following options for each article:

    Table 1. Options for knowledge base launchpad articles
    Option Description
    Live This option controls whether the article is imported to the knowledge base in online or offline state. All articles are set offline by default. If you set an article live, it will be immediately available on touchpoints once you launch the article.
    Article Title Displays the article title and the number of phrasings available for the article. Select the number to see the phrasings.
    Content The body of the article. You can add the content you want to present as a response to the question that is in the Article Title.
    (Delete) This option enables you to delete specific articles from the list.
    (Launch) With this option you can launch a specific article.
  4. Optional: Add new articles as you see fit.
  5. Launch all articles using the button at the bottom or launch articles one by one.
    Note: Once you launch a package in a knowledge base, it can't be launched to the same knowledge base again.
The articles you launched are available in your knowledge base under Knowledge > Articles.

What is the knowledge base launchpad?

The knowledge base launchpad in Bold360 AI enables content managers to jumpstart a knowledge base.

Note: The knowledge base launchpad is not available by default, it must be enabled for the knowledge base on account level. For more information contact your Customer Success Manager.

The knowledge base launchpad offers several packages content managers can choose from depending on the nature of the knowledge base they want to set up. The packages contain a set of intents with phrasings which serve as examples and guidance for content creation and can be changed. To access the knowledge base launchpad, go to Knowledge > Launchpad.

With the knowledge base launchpad, content managers can:

  1. Select from a list of predefined content packages
  2. Review the content of the package
  3. Edit the content of the package such as edit the intent, the phrasings and the content of the article
  4. Delete articles from the list that are not needed and add new ones
  5. Set articles live
  6. Launch the entire package or specific articles of the package to the knowledge base

See How to use the knowledge base launchpad to learn more about how to use the launchpad.

Creating Dedicated Language Knowledge Bases

Bold360 AI allows you to have a separate knowledge base per language. When a customer asks a question, the answer is provided from the knowledge base that matches the language of the question.

Make sure dedicated language knowledge bases have been created for you. Contact your Customer Success Manager for more information.
  1. In the AI Console, go to Touchpoints > Widgets > Get the code and select a widget.
  2. Choose the knowledge base of that specific language from the Choose Knowledge Base drop-down menu.
    Note: For slim widget, select Enforce KB and then select your knowledge base. For legacy code, select Get legacy embedded code and then select your knowledge base.
  3. Copy the code and insert it into the foreign language pages script.

How can I handle various languages on the same topic?

There are two recommended ways to support your customers in various languages:

  • Use one knowledge-base for your local language and provide on-the-fly automatic translations. Read more here.
  • Create several knowledge-bases; one for each language. This option will ensure more accurate translations. Read more here

How do I add an additional phrasing to an existing article?

To add an additional phrasing to an existing question/answer, do the following:

  1. Go to Knowledge > All Articles in the Bold360 ai navigation menu.
  2. Search your question in your online Knowledge Base.
  3. Select your question (article) and click Phrasings.
  4. Enter a new phrasing and click Add.
  5. Click Publish to save the new phrasing.

How to create good phrasings for your article?

  1. Add synonyms. (For example: I want to buy tea: buy|porches|sell|stock|get etc.)
  2. Do not add more than 5-10 phrasings per article. That will make precision less accurate.
  3. Add keywords in your phrasings (from the previous example: tea).

For more information about phrasings, see these articles:

How do Synonyms work?

Best practices for phrasings and synonyms

How to create data source entities

Use data source entities in Bold360 AI to turn your data into smart conversations.

Make sure your widget is set to conversational. Learn more here.
In this example, we have a list of mobile phones and we want to create a bot that recommends users the best mobile devices based on their needs. We are going to set up a data source entity based on this list of mobile phones and then create an article that uses this entity.
  1. Create the list of mobile phones in a CSV file.

    A sample CSV file is attached at the end of this article. Learn more about the different data source options and requirements in this article.

  2. In the AI Console, go to Knowledge > Entities.
  3. Choose (Create Entity).
  4. Select data source entity for entity type.
  5. Provide a name and optionally a description for the entity.

    The entity name can contain letters, numbers and underscores. Spaces are not allowed.

    You can use the description to give the entity a more meaningful name or description that helps you identify it later.

    Example: Name your entity MOBILE_PHONES.

  6. Fill out the Data Source URL field.

    You can select the CSV file from your local computer and upload it to Bold360 AI' secure server or you can upload the file to a file hosting service like OneDrive and enter its URL here.

    Note: If you provide a link to the file's location, make sure it's publicly accessible.
    See What are the data source URL options? for more options.
  7. Set the response type to CSV.
  8. Choose LOAD.

    Result: The properties table is now loaded. Properties are the columns that are available in the data source file.

  9. Fill out the Properties table.

    See What are the property options for data source entities? and How do life cycle options work? to learn more about the options.

    Example:

    You should decide what questions the bot should ask the end users to offer the best possible recommendation about phones. In this example, the bot asks questions about brand, price range, and camera quality.

  10. Optional: Define fallback messages.

    See What are fallback messages? to learn more.

    Example: For this example, we enter Unfortunately, there's no mobile device that matches your preferences. for no results and set up a carousel to be displayed with the image, the brand and model, and the price if there are multiple results based on the customer's responses.

  11. Save your changes.
  12. Now go to Knowledge > Articles.
  13. Create a new article or open an existing one and add the entity in the article's body.

    In the article's body, create the final response of the bot: this is what the bot responds when there is a single mobile device to recommend. The response should use the entity to present the details of the selected mobile device. To insert an entity, you can either choose or enter [[ in the text editor and have a drop-down of all entities displayed. Once you add an entity to the response, the entity is automatically added to the article. You can expand the entity to see the questions that the bot may ask the user and adjust them to fit the article if needed.

    Note: You can drag-and-drop entities in the Article Editor to control the order of the questions in the conversation.

    Example: Intent: I want to buy a mobile phone

    Body: ?

  14. Publish the article.

You can now see the conversation in action in your widget ? just enter I want to buy a mobile phone.

Important: The bot doesn't always ask all the questions we set in the entity. It can automatically identify when there is no need to ask a question, for example, when there is only one possible result left. In addition, the order of the questions might differ as the bot automatically chooses the order based on what it estimates as the fastest way to get to a possible answer.

What are quick action events?

When using Quick Action buttons, a special event can be created.

An event can be setting a new context or changing an entity value. Events can help you gather more information about your users and their specific preferences so that the bot can present the most relevant content for them.

For example, let?s say we have a context called User Type, and its value are Basic and Advanced. Suppose we have an article providing a general overview of our product. We can add a quick button like Learn more with an event that changes the User Type context to Advanced. Therefore, when the bot displays the Learn more article, it presents the variation of the article that has Advanced context.

Important: For a context value to be successfully set using an event, the context category must have Detect from user search enabled.

How else can you use context-based quick action buttons?

Let's say, you want to offer different shipping information for website visitors who are currently looking at an item and visitors who have actually purchased that item. In this case, you can create a shipping-related article with two variations: one where the context called purchased is set to true and one without any context defined. Then in your main article, you create the quick action button and define an event to open the shipping-related article when the visitor clicks that button. In this case, visitors who are just looking for an item may find general shipping information, while customers who have purchased that item may see the date when they are supposed to receive their products.

Tip: You can use synonyms to cover different user inputs. For example, if the buttons show Yes and No, you can create a synonym group that includes yes, yeah, ya and so on. This way, if the user types yeah instead of choosing the Yes button, they still receive the relevant answer.

How do I define conversational flows?

There are multiple ways to enhance the conversational bot with call-to-action activities that enhance the user experience and help guide the flow and suggest options to the user. These can be added to the regular answers using the Conversation tab in Digital DX AI.

  1. In the AI Console, go to Knowledge > Articles and create a new article.
  2. On the Conversational tab, click the Conversation Enabled toggle to enable the conversational editor in the Article Editor.
  3. Select Add Flow.
  4. Add the main answer in the Content field that appears.
    Tip: If you want to display the content in multiple bubbles, enter the <page_separator/> tag in the text where you want to separate the content.
  5. Optional: Add rotating content.

    You can add variations for the content to create a more human-like user experience.

  6. Select +Child to create the options.
    Note: It is recommended to use between 5-7 quick buttons to avoid scrolling on the page.
  7. In the Title field that appears, enter the text you want to display on the button.

    The text on the button can be up to 20 characters long.

    Tip: Use synonyms to cover different user inputs. For example, if the buttons show Yes and No, you can create a synonym group that includes yes, yeah, ya and so on. This way, if the user types yeah instead of choosing the Yes button, they still receive the relevant answer.
  8. Select the type of button you want to use.

    You can either use quick buttons or persistent buttons. Quick buttons appear under the content as separate buttons and once the user selects an option, the rest of the options disappear. Persistent buttons appear as a list under the content and all of them remain visible to the user after they select one. Use the quick button if only one of the options is relevant to the user. Use the persistent buttons if multiple options could be relevant to the user.

  9. Add the content that is to be presented upon clicking the button.

    You have the following options:

    • Content: Enter the content that is to be presented to the user when they click on the button.
    • Variation ID: You can specify the article variation that is to be presented to the user.
    • Article: Use this option to direct the user to an answer in the knowledge base. You can search for articles by title.
    • Statement: Use this option if the answer has more variations associated with different contexts and you want the bot to display the relevant variation based on context. Enter the title of the article with multiple variations.
    • URL: You can create a link to a webpage with this option.
    • Phone Number: You can use this option to add a phone number and call the number defined when clicked.
      Note: Using this option affects the channeling score for phone on the Dashboard. For more information about the channeling score see What do I see on the Dashboard?.
    • External: Use this option to transfer parameters to an external interface. This is useful for handshaking with a customer app that uses certain parameters from the conversational bot.
  10. Optional: Besides plain text, you can also insert HTML elements in the conversation tree to enhance the conversation's look and feel, as well as its functionality. For example, you can enter a link in the conversational statement by adding an HTML tag in the Article Editor's text field.

How do I review overlapping phrasings?

While editing an article, you notice that it has overlapping phrasing.

Digital DX AI enables knowledge managers to easily optimize phrasings by providing a list of articles that use the same or similar phrasing.

  1. In the Article Editor, select Overlapping phrases above the intent.

    This button is only available for an article that contains overlapping phrasings with other articles.

  2. On the Overlapping phrases dialog, select an article from the list to open it for editing on a new tab.
  3. Edit the phrasing of the article you just opened or go back to the original article and edit the relevant phrasing there.

    Unique phrasings ensure visitors get the most relevant results during search.

  4. Publish the articles.

What are the best practices for the bot's introduction message?

Learn how to best set up an introduction message for the bot to make the most of the bot experience.

When the widget is presented, display an introduction that follows these guidelines to set proper expectations:

  • Let customers know they are chatting with a bot or virtual assistant and not a live person. We recommend you include terms like bot or virtual assistant in the introduction message. Be consistent in how you refer to the chatbot.

  • Give a few examples or some explanation on what the bot can and can't answer, for example, I understand short and simple questions best.
  • Tell customers what happens if the bot can't help, for example, they can start a live chat or call customer service, depending on what channeling you have set up.

Making clear that the customer is engaging with a bot and not a human being sets the customer?s expectations and prevents disappointment and frustration. It also encourages the customer to phrase their questions appropriately.

Tip: We recommend adding the introduction message as an FAQ title in the widget configuration, rather than specifying an auto question. An auto question may count as an interaction and therefore engagement and as such could end up in reporting.

Learn how to find answer, in product, with Bold360.

 

How do I use quick actions in articles?

Quick action buttons in an article allow you to easily link between different articles.

Quick actions provide visitors with different flows that are based on their preferences and create a conversational-like experience for them.

  1. In the AI Console, go to Knowledge > Articles and create a new article.
  2. In the Article Editor, click Quick Actions or Persistent List at the bottom of the page.
  3. Name your button and select its type. Button type defines the action that happens when the customer selects it:
    • Content: enter the ID of the article that you want to show to visitors.
    • Article: enter the name of the article that you want to display. The bot automatically picks the best variation if there are mutiple variations.
    • Variation ID: enter the ID of the article variation that you want to show to visitors.
    • Statement: use this option if the answer has more variations associated with different contexts and you want the bot to display the relevant variation based on context. Enter the title of the article with multiple variations.
    • URL: the URL of a website that the visitor is redirected to.
    • Phone number: a phone number that the visitor can call.
    • External: use this option to transfer parameters to an external interface. This is useful for handshaking with a customer app that uses certain parameters from the conversational bot.
  4. Choose Event for the quick action to select a context or an entity and a value.

    The button action will only be triggered when the customer selects the defined event properties.

    Note: This is only available for Content, Article, and Statement button types.
  5. Save your changes.

How do I make pages noindex?

In the AI Console you can set noindex for the entire support center or for individual articles.

How do I set noindex for the entire support center?

  1. Go to Touchpoints > Support Center.
  2. Select the support center and go to the Page Templates tab.
  3. In the master page template, add the line in bold inside the head tag:
    <html>
      <head>
        <title>...</title> 
        <META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW"> 
      </head>
  4. Save your changes.

How do I set noindex for an article?

  1. Go to Knowledge > Articles > .
  2. Find the article you want to make noindex and open it for editing.
  3. On the Visibility tab, select the Do not index this article option.

    Result: The article is added to the robots.txt file.

  4. Publish the article.

How do I hide an answer from the widget FAQ?

You may not want to promote a frequently asked customer question by showing it in the Product Page FAQ or Support Page widgets.

  1. In the AI Console, go to Knowledge > Articles.
  2. Find the article you want to hide.
  3. On the Visibility tab of the Article Editor, clear the FAQ Widget option.
  4. Publish the article.

How do I turn an article offline?

Setting articles offline enables you to hide articles from your touchpoints without deleting them.

It is possible that you have articles in your knowledge base that are only relevant during specific times of the year, such as campaigns. Instead of deleting such articles, you can set them offline.
Remember: Setting articles offline instead of deleting them ensures reporting insights remain intact. If you delete articles, you lose all insight into how these past articles performed.?
  1. In the AI Console, go to Knowledge > Articles.
  2. Find the article you'd like to set offline and open it for editing.
  3. Turn off Set Live to set the article offline.
  4. Publish the article.
The article is no longer accessible on touchpoints, but it is still available in the knowledge base.

How to import multiple articles in a batch with the API

You can import a large number of articles in a batch through the API.

Important: If the Dual control of article approval option is enabled for your account, article import through the API is not possible. Contact your Success Manager for more information.
Articles can be imported to the knowledge base through the API when the Enable approval workflow option is enabled for an account. Such articles will be in Published status and they are set live in the knowledge base.
Note: It is not possible to import system labels like Never Published, Draft, Offline or Hide in Support Center.

To learn more about how to import articles through the API, visit our Rest API & SDK Reference.

What are the best practices for conversational articles?

Follow these guidelines to make the most of Digital DX AI's conversational capabilities.

Remember the following guidelines when creating conversational articles:

  • If you have Yes and No branches in a conversational flow, order Yes first and No second to keep the flow natural.
  • Add labels to conversational articles like parent, child or conversational, so it's easier to find and edit them.
  • When using instant feedback, add the <no_feedback/> tag at the end of the question or option if you don't want feedback to appear for that step.
  • If you use multiple bubbles, include a delay to the messages to give users time to read. The wait times should depend on the length of the messages. When messages are sent right after one another, it feels more natural to pause a little longer and longer with each new message, even if they may be around the same length, so that users have time to finish reading older messages before newer messages are sent out.
  • Adjust the character limit for bot messages and ensure articles are within that limit to make sure customers don't have to use the Read More button to see the full article.
  • We recommend you use large persistent buttons rather than quick buttons as customers usually prefer the ability to click on previously displayed buttons.

What are the best ways to humanize the bot?

Here are a few tips to keep in mind to make bot conversatitons more human-like:
  • Setting up a humanized greeting increases the likelihood that customers choose to interact with the bot. It is important however to make it clear that they are talking to a bot, not a human being. See this article for more best practices about the bot's introduction message.
  • Make conversations flow as naturally as possible.
  • Keep answers short and to the point.

How do I delay an answer part when using multiple chat bubbles?

When you present an answer in multiple bubbles in a conversational widget, you can delay the presentation of the individual answer parts. Presenting a longer answer in multiple parts engages the user more.

To have your content appear in multiple bubbles, make sure you use a chat widget that is set to Conversational widget mode.

To set a delay for the bubbles after the first one, do the following:

  1. Create an article with multiple pages or open one you already created.

    Not sure how to create one? Follow the steps in this article.

  2. Set a delay for page 2.

  3. Set a delay for other pages that follow.
When the conversational widget displays this article, the content of the pages is presented one after the other in a separate bubble either immediately or with the selected delay.

How to use quick options in a conversational article

When using entities in conversational articles, you can use quick option buttons to present possible answers to a question.

When a property of an entity has quick options enabled, the widget displays results to the customer as a list of options to choose from. It is possible to use a maximum of 10 quick options.

You can enable quick options for a property in the entity as well as in the Article Editor.

Note: If you disable quick options for a property in the entities editor, you can't enable them for the property in the Article Editor.

See What are entities? to learn more.

What is semantic NLP search?

Many search technologies have been based on keyword search, these platforms cannot easily distinguish between words spelled the same way that mean something different. This often results in irrelevant query responses.

Unlike these older systems, semantic natural language search (NLP) systems are able to glean the meaning behind the query and comprehend the natural way that people ask and offer answers to each other. The results that you receive are about the query and theme you are exploring, not merely matched based on similar keywords.

This technology is the closest thing we have today that can somewhat "read the minds" of your customers. By not limiting the language that users express themselves, this technology can discover the intent of the query and delivery relevant answers. Giving your customer service technology the human touch that is necessary for a quality customer experience.

Template Answers Overview

Template answers enable your Bold360 AI solution to answer product attributes-related questions (e.g., what is the price?, what is the size?, color, etc.).

Instead of creating multiple answers for multiple specific questions ('what is the color of dinner plate A?' 'what is the color of dinner plate B?), you only need to create one Q&A ('what is the color?') and insert a template script inside the answer so the answer varies depending on the product ('The color is blue").

An example:

An end user visits one of your product pages and asks about the product's color (In this case, the color of a dinner plate). Your products (dinner plates) come in two colors: blue and orange. By using a color attribute, all you need is to create one question in your Bold360 AI knowledge base: "What is the product's color?"

The user will receive an answer about the actual product's color depending on the product page that they are currently visiting. If the user is on the blue dinner plate page, the answer will be: "The product color is blue" and if they are on the orange dinner plate page, the answer will be "The product color is orange".

Why does the article title differ from the autocomplete suggestion?

As the user is entering a question in the search in the Support Center or in the widget, the autocomplete continuously checks for and returns the most likely responses that are identified based on our Natural Language Processing (NLP) algorithm and popularity.

The autocomplete can present any phrasing associated with articles. Knowledge base managers can control whether an article phrasing is returned in autocomplete with the Autocomplete checkbox next to the phrasing.

Once the user selects an autocomplete suggestion, the article associated with the selected phrase is presented. The title of this article may differ from the phrase the user selected.



Figure 1. What Autocomplete displays


Figure 2. What selected article looks like

Can you support multiple websites from one knowledge-base?

Yes, Bold360 AI supports multiple websites from a single knowledge-base, but you must set up a separate widget for all your websites.

However, it is recommended to separate the knowledge-bases in case of completely different content.

For more information, see How do I add another knowledge base? and What widgets do you provide and how can I add them to my website?

Bold360 AI for supporting multi-lingual websites

Companies often have to support customers in multiple languages, which requires having the same topic available in several languages. There are two recommended methods to provide multi-lingual interactions with your customers:

  1. Bold360 AI offers automatic language translation using multiple language translation engines. It enables you to answer your international visitors and create/respond to tickets in any language - especially if you do not have agents speaking a specific language. The translation engine supports more than 34 languages (using Google translate V2). The quality of Bold360 AI's automatic translation from English to 34 foreign languages is almost as high as from our dedicated knowledge base per language.
  2. Bold360 AI allows you to have a separate dedicated language Knowledge Base for each language, including Asian languages such as Korean or Chinese, and many more. That way, you can associate each Knowledge Base with a different language on your website. When a user asks a question, a native answer from the dedicated Knowledge Base will be provided (instead of a translated one). We recommend beginning with your English-language Knowledge Base - typically always the largest - and then translate all its content into the foreign language of your choice to make your full set of answers available to more users.

Create a Bold360 AI answer button in a conversational article

The conversational chat is not designed to work with the regular method of the Bold360 AI answer button.

Note: Before you begin, make sure that Conversational feature is enabled on the Basics tab of the widget settings (select Conversational for Widget mode.)

To display the Bold360 AI answer link, follow the instructions below:

  1. Open the relevant article.
  2. On the Conversational tab, click the +Child button.
  3. Add the button title, and select quick button > article ID then type the article ID in the field below.
  4. Publish the article.

Please note that the link will be presented as a button at the bottom of the answer.

How do I convert a specific or personal question to a general one?

The knowledge base is populated with new Q&A content taken from incoming users questions. Most of these incoming questions are personal or relate to specific criteria.

Most of these questions can be converted to general questions and answers (relevant for any user who might ask a question related to this subject), which will be added to the knowledge base.

Example of personal questions and a typical conversion to a general form:

  • Personal question: "What is the status of the order number #123456? It has been 5 days already!"
  • General question: "What is the the status of my order?"
  • General answer: "The status of your order can be found on the order page..."

After converting a personal or specific question to a general one, please make sure to provide a general answer as well.

How do I upload content into the knowledge base?

Content can be extracted from your current content management system and uploaded into Bold360 AI using the attached Excel template.

The fields to be captured per article:

Column 1- article title

Column 2 - article body. The article body is preferably to be provided with HTML formatting.

Column 3 - article labels. For general information about labels click here.

Column 4 and on - article contexts and context values. Each column should represent a single context type. Within this column for each article capture the relevant context values. For general information on Context see What are Bold360 AI contextual answers?

In order to upload the content please contact your Success Manager or send the file to support.

Synonyms and conversational flows

Synonyms are used to enhance your Knowledge Base (KB) and improve search results. There are two types of synonyms in Bold360 AI:

  • Local synonyms: The synonym repository in the KB which is created and maintained by your content management team. Local synonyms typically include words that are related to your business and serve as an extension to the list of global synonyms.
  • Global synonyms: Language-specific global synonyms that Bold360 AI uses which are relevant across all verticals.

For your conversational flows, synonyms are especially important as you will have to anticipate the different ways customers are looking for your goods or services.

The following is an example of global and local synonyms as seen in the Article Editor:

When you look at the synonyms of create, you see that "add" and "make" are defined locally. At the same time, "build" and "open" are defined as global synonyms that are also applied when a customer enters an intent.

How to add synonyms

The synonyms you add are applied to all articles in the knowledge base.

Create groups of synonyms broaden your terminology base and deliver the information your customers are looking for.

There's no need to update each question separately. Once a group of synonyms is created, it takes effect across the entire knowledge base.

Create and edit synonyms from the Synonyms page

  1. Go to Admin Center > KB Setup.

    The Knowledge base: Synonyms page is displayed.

  2. On the Knowledge base: Synonyms page, click Add new synonyms group.

    The Synonym group editor is displayed.

  3. Enter words which you want to treat as synonyms.

    Once you've entered the first word, the editor will recommend other relevant synonyms to choose from. You may either choose from the recommended words by clicking on them or enter your desired words in the New synonym box.

  4. Click Save.

    The Synonym words editor opens.

  5. Select the synonyms that should be associated with the words that you have.

    In the example above, the synonym "ms" was defined as synonym for "microsoft". The NLP engine considers "ms" as the plural form of "m" and, unless you clear the checkbox for that word, the engine adds that word as a synonym to "ms".

    If you define multiple words as synonyms then all those words are listed on this page.

  6. Click Apply to save your synonym group on the Synonyms page.
Note: To delete an existing synonym, click the trash icon next to the synonym group.

Create and edit synonyms in the phrasings editor of an article

  1. Go to Knowledge > Articles and open an existing article or create a new one.
  2. In the article editor, open the Phrasings section and click Synonyms.
  3. Click +Add to create a group of synonyms.

You may notice how the same question repeats itself in different phrasings with similar words. Once we create groups of synonyms, all four questions can be minimized into one. If there's already an existing group of synonyms for a word, you may edit the group by clicking on the synonyms. When editing a group, the synonym group editor opens.

What are dependent entities?

Dependent entities are entities used in other entities.

When you have an entity with an API as data source, you need to set up a custom entity that collects the information from the user and and include this custom entity in the API-based data source entity to pass it on to the API. Dependent entities provide a better understanding of what properties compose the entity.

To add dependent entities, do the following:

  1. In the AI Console, go to Knowledge > Entities.
  2. Select an existing entity or create a new one.
  3. Choose click URL inputs next to Data Source URL.
  4. Add the entity you want to use.

    You can add an entity on the Parameters,Headers or Bodytab, depending on where it's needed. The entity should be added in [[Entity_Name.Property.Name]].

The dependent entities are listed under the Properties Table.

What are the property options for data source entities?

Property options in Bold360 AI enable you to customize entities.

The options listed here are available in the Properties table of data source entites. Some of them you can find under (More options).

Table 1. Property options for data source entities
Option name Description
Life cycle The Life Cycle field above the properties table sets the life cycle for the entire entity. You can also set a life cycle for each property. Properties can have a life cycle that is shorter than the life cycle of the entity as a whole. For more information about life cycles, see How do life cycle options work?.
Expose? Sets the visibility of this property in a conversation.
Key Displays the header names as they are in the data source.
Name The expression used to identify the property and add to articles. The property name can contain letters, numbers and underscores. Spaces are not allowed.
Detect Controls whether the property is visible in a conversation.
Query The question the bot asks to receive the input from the user.
Life cycle The Life Cycle field of the property sets the life cycle for the specific property. You can also set a life cycle for the entity. Properties can have a life cycle that is shorter than the life cycle of the entity as a whole. For more information about life cycles, see How do life cycle options work?.
Split by A syntax value such as a comma or a vertical bar that is used to separate multiple values in a CSV cell or in the value associated with a JSON key.
Auto Spelling When selected, the customer's answer doesn't have to be an exact match to a value in a CSV cell or a value associated with a JSON key.
Is Shared You can share the selected property with another entity. For example, if you define color in your phone and tablet entities, then you can share the color values across entities. In this case, when the customer selects a phone color that doesn't exist in the phone entity but exists in the tablet entity which is shared, then the bot will know it is a color and present the message defined in the entity for no results.
Autocomplete When selected, customers are offered autocomplete, or type-ahead options as they enter the entity value.
Use Quick Option The customer can choose from the values that a specific CSV column or JSON key contains. For example, if the CSV contains Apple, Samsung, and Google in the Brand column for a list of mobile phones, these options are displayed as buttons to the customer. See How to use quick options in a conversational article to learn more.
Parent property You can set up a dependency between two properties of the same entity. For example, the parent property of Cities can be Country. When the customer is asked about these two properties, the following happens:
  • The bot asks the question for the parent property first. For example, What country are you located in? and then Which city do you reside in?.
  • If the Country property is either asked again or deleted, the City property is also deleted, that is, the child property behaves in the same way as the parent property.

How do life cycle options work?

The life cycle of an entity in Digital DX defines the period during which the bot remembers the user's answer.

You can define a life cycle for the entity as well as for each property of the entity. Properties can have a life cycle that is shorter than the life cycle of the entity as a whole.

Table 1. Entity life cycle options
Life cycle option Description
Persistent The bot remembers the user's answers for the duration of the session, that is, until the user closes the browser.
Topic The bot remembers the user's answers as long as the articles returned to the user's questions contain the entity. So as soon as the user asks the bot for an article that does not use the entity, the bot deletes the user's answer from its memory.
Intent The bot remembers the user's answer as long as the user is in the same intent. So as soon as the user asks the bot something else, the bot deletes the user's answer from its memory even if the answer to the user's next question contains the same entity.
Statement The bot remembers the user's answer until another question is asked from the user. For example, if the bot asks two questions, like What is your first name? and What is your email address?, the bot forgets the user's first name before the second question is asked.

What property options are available for custom entities?

Property options in Bold360 AI enable you to customize entities.

Table 1. Property options for custom entities
Option name Description
Life cycle The Life Cycle field above the properties table sets the life cycle for the entire entity. You can also set a life cycle for each property. Properties can have a life cycle that is shorter than the life cycle of the entity as a whole. For more information about life cycles, see How do life cycle options work?.
Name The expression used to identify the property and add to articles. The property name can contain letters, numbers and underscores. Spaces are not allowed.
Detect Specifies the type of input expected from the user, like text, date or number. Validation is completed based on the selection here. For example, if email is selected, the user is expected to enter an email address, otherwise they receive an error. If you choose Date, customers can use a calendar to select the date:
Bot Query The question the bot asks to receive the input from the user.
Error Message The error message displayed to the user when they provide an input that is not valid. You can also set the number of times the error message is to be displayed, that is, the number of chances you give the user to provide the correct format. After that the user receives the fallback message. For example, you have a property where Detect is set to Email, the bot query is What's your email address? and the error message is Please provide an email address. which is set to be displayed 3 times. When the user fails to provide an email address for the fourth time, the fallback message or article is displayed if it is set up.
Note: Validation is not possible for text-type properties, so you can't enable error messages for such properties.
Life cycle The Life Cycle field of the property sets the life cycle for the specific property. You can also set a life cycle for the entity. Properties can have a life cycle that is shorter than the life cycle of the entity as a whole. For more information about life cycles, see How do life cycle options work?.

How to create API-based entities

Entities in Bold360 AI enable you to turn your data into smart chatbot conversations.

Note: The steps described in this article require web developer knowledge.

To set up an API-based entity you need a custom entity to collect data from the customer for the API, a data source entity with the API as its data source that uses the custom entity and an article you use these entities in. In this example, we have an API for data about concert tickets and we want to create a bot that the customer can ask about the tickets that they already booked.

  1. Create a custom entity.

    You create this entity to collect the data required for the API. In this example, we're asking for the customer's email address to display their booked concert tickets.

    Example:

    Entity name: TicketDeails

    Entity description: Collect the customer's email address

    Table 1. Property table of TicketDetails
    Name Detect Bot Query ErrorMessage Life Cycle
    Email Email What's your email address? Please enter a valid email address. Persistent
  2. Create a data source entity with the API as its data source.
    1. Choose (Create Entity).
    2. Select custom entity for entity type.
    3. Provide a name and optionally a description for your entity.

      The entity name can contain letters, numbers and underscores. Spaces are not allowed.

      You can use the description to give your entity a more meaningful name or description that helps you identify it later.

      Example:

      Entity Name: TicketsByName

      Entity Description: Get a list of tickets by email address

    4. In the Data Source URL field, enter the URL of the API and add the property of the custom entity you created in Step 1.

      Example: https://api.example.com/v1/tickets/[[TicketDetails.Email]]

      Result: The custom entity is listed as a dependent entity under the Properties Table. See What are dependent entities? to learn more.

    5. Change Response Type to JSON.
    6. Choose LOAD.
    7. On the set parameters samples dialog enter a sample email address and choose LOAD.

      This way the system knows what a valid response looks like.

      Result: The Properties table is automatically filled with the keys that come from the API.

    8. Define display settings.

      Display settings are available for arrays. See What are the display settings for API-based entites? or more information.

    9. Save the entity.
  3. Create an article that uses these entities.
    1. Go to Knowledge > Articles.
    2. Create a new article or open an existing one and add the entity in the article's body.

      Example: Intent: What tickets do I have reserved?

      Body: ?You have the following tickets reserved: [[TicketsByEmail.TicketsByEmail_ARRAY]]

    3. Publish the article.

What are system entities?

You can use built-in, or system entities even without defining your own ones. These Entities let you define the following:

  • NUM - Stores the numeric value that the user enters.
  • EMAIL - The answer displays the email address that the user entered as part of the intent.
  • DATE - User can either select a date from a date picker or type a date in MM/DD/YYYY format. The answer displays that value in MM/DD/YY format.
  • DATE_TODAY -
  • DATE_TODAY_DISPLAY -
  • DURATION - Converts weeks, days, hours, and minutes into number of days.
  • DATE_RANGE -
  • DATE_RANGE_PAST -
  • DATE_RANGE_FUTURE -
  • LOCATION - Returns the user's geolocation (latitude and longitude coordinates).

How can I use entities in user search?

What are the display settings for API-based entites?

Display settings are available for arrays in API-based data source entities.

Choose for an array in the Properties table of your API-based data source entity to set up the following options:

  • Display results in a carousel
  • Display results as quick buttons
  • Display a message when there are no results

Conversation entity verification

As a content manager, you can create conversations that verify answers that end-users provided and to prevent any typos or other human errors. To do that, create a new step in the process of API-based entities that will do the following:

  • Summarize the data the user has provided
  • Present the data to the user in the widget
  • Enable the user to change the data if needed or to confirm.

How do data source entities work?

Use data source entities in Bold360 AI to turn your data into smart conversations.

Data source entities can be based on a CSV or a JSON file or can retrieve data from an external data source through an API. In terms of the data source, you have the following options:

  • Upload the file from your local drive
  • Upload the file to a file hosting service like OneDrive and add its URL to the entity
  • Specify the URL of an API
See What are the data source URL options? to learn more.

Makes sure the CSV or JSON file you use with entities meet the following requirements:

  • The file is valid, for example, the CSV file contains no unescaped commas. Use a validator tool to check.
  • If you provide a link to the file's location, make sure it's publicly accessible.
  • The file is structured in a way that
    • Each bot query corresponds to a column
    • Each response corresponds to a row or a part of it
    • Columns are divided into two parts: bot queries and answers.
See this article to learn how to set up an entity with a CSV data source.

What are entities?

Entities in Bold360 AI enable you to turn your data into smart chatbot conversations.

Tip: Check out this video to see entity configuration in action.

Entities serve as a database for the information that the conversational bot needs to answer your customers' questions. You set up an entity with a data source and provide different questions the conversational bot will ask the customer about the same set of data. For example, you have a data source for mobile phones and you want to create a conversational bot that recommends your customers the best mobile devices based on their needs. Your data source contains information about the brand, the model, the price, the screen size and so on of the mobile phones available. In the entity, you can set up questions about these bits of information, like Any specific brand you're looking for? and What is the price range?. The customer answers these questions and the conversational bot provides the best fit or fits based on their answers.

With entities, you can provide a smart conversational experience to your customers:

  • If the customer provides an answer to a question that the conversational bot hasn't asked yet, it won't ask that question. For example, if someone is looking for an iPhone with 64GB memory, the bot will skip the question about memory type and potentially the one about phone type as well.
  • The conversational bot presents the questions in the most effective way to ensure the customer has to provide the least number of answers to find the result. So regardless of the order of the questions in the entity, the conversational bot rearranges the questions in the most logical way.
  • When a question has one answer only, the bot simply skips that question and does not present it to the customer. For example, if there is only one Samsung phone with a 7" screen, the bot doesn't ask the customer about either the camera or the memory of the phone, but displays the result immediately.

Bold360 AI supports the following types of entities:

  • Data source entities where the data comes from
    • a CSV or a JSON file or
    • an external data source through an API
  • Custom entities that you can use
    • to collect information from your customers in an interactive way
    • an auxiliary for API-based data source entities as they help collect the information required for the API and then trigger the API itself

What are the data source URL options?

Use these options when providing a link to a file or an API link in the Data Source URL field of a data source entity in Bold360 AI.

When creating a data source entity, you can either upload a CSV or a JSON file from your local drive or add a URL to such a file or provide the URL of an API as data source.

Entities support two types of HTTP methods to integrate an external URL: POST and GET. You can select a method from the drop-down next to the Data Source URL field.
The following options are also available for data source URLs:

  • URL inputs which enable you to add header and body content
  • Interval settings where you can set the refresh interval for how often the cached version of the file is to be refreshed
  • Download file to get a local copy of the file

URL Inputs

To integrate an external data source, you may need to use specific parameters, headers or include specific data in the body of the request when you send it to the server that stores the data files.

When you select (URL Inputs), you have the option to add parameters, headers and a body in case of POST requests. It is possible to include another entity as a parameter, in the header and in the body in which case this entity is listed as a dependent entity under the Properties table. See How to create API-based entities to learn more.

Headers

In several cases, POST requests require specific headers to be sent to the server. When testing a POST request, the tool you're using might automatically add certain default headers without even showing them to you. Make sure you add all headers in the entity configuration.

Body

In the body you can add content. The body of an HTTP request supports different formats for sending content. The format you should use depends on what the receiving server expects. In the AI Console, POST requests in entities support raw format only.

What are negative phrasings?

Negative phrasings tell the bot what customer voices an article should not answer.

Negative phrasings are the opposite of phrasings, which serve as alternative titles for articles so that customers can find an article with multiple search terms.

You can add negative phrasings to an article in the Article Editor and in Search Optimizer. By adding a negative phrasing to an article, you can make sure that Digital DX AI doesn't return the article to a customer question that it doesn't answer.

Note: To use negative phrasings, you must have the Enable negative examples option enabled for your account. Contact your Customer Success Manager to enable these features for you.

Why would you add negative phrasings?

You have near identical titles with substantially different content

For example, you may have the following two internal articles for your support agents:

  • How to treat customers
  • How not to treat customers

From a Natural Language Processing point of view, these phrasings are very close in meaning, therefore Digital DX AI would display both articles when your agents search for how to treat customers. You can avoid this by adding the title of the other article as a negative phrasing to the articles.

A question is answered by an article that should not answer the question

In this case, you can do the following:

  • Add the question as a negative phrasing to the article that doesn't contain the relevant information.
  • Add the question as a (positive) phrasing to the article that does have the answer.

How to delete an article variation

When you have multiple answers for a question and you no longer want to display different answers to this question based on context, you can remove the article variation.

Remember: If you delete articles, you lose all insight into how these articles performed in the past. To ensure reporting insights remain intact, set the articles offline instead.
  1. In the AI Console, go to Knowledge > Articles and open the article you have already created.
  2. Under Context Variations, choose next to the variation you want to delete.

    Result: The Duplicate and Delete options appear.

  3. Select Delete variation.
  4. Choose OK on the confirmation that is displayed.
  5. Publish the article for your changes to take effect.

How can I mark parts of an article as confidential?

Mark content as confidential to reduce the risk of agents sharing internal only info from Smart Advisor.

Make sure that the Smart Advisor touchpoint is enabled in your account. For more information contact your Customer Success Manager.
  1. In the AI Console, go to Knowledge > Articles.
  2. Select an existing article or create a new one and add content in it.
  3. To mark part of the content as confidential, select the relevant part and choose (Confidential Info) in the editor.

    Result: The selected text appears in brackets now.

  4. Publish the article.
When this article appears in the Smart Advisor in the Agent Workspace, agents can't copy the parts that are marked as confidential.

How to add negative phrasings in the Article Editor

You can set a phrasing as negative in the Article Editor so that the bot knows what customer voices the article should not answer.

Note: To add negative phrasings, you must have the Enable negative examples feature enabled for your account. Contact your Customer Success Manager for more information.
  1. In the AI Console, go to Knowledge > Articles.
  2. Open the article in the Article Editor and view its Phrasings.
  3. Enter a new phrasing and click Add.
  4. Click Set as negative next to the phrasing.

  5. Publish the article.

How to manage localization in the Digital DX  AI platform?

One of the most efficient ways to manage translations/localization is to use GeoFluent, which works in search and conversational widgets alike. However, if you do not have a GeoFluent account, you can still use Digital DX AI's built-in translation management feature: as a Knowledge Manager, you can control the localization of individual articles, directly from the Article Editor.

Important:
  • This solution is limited to search widgets.
  • You must have at least two knowledge bases set up on your account that are part of the same translation group. Contact your Customer Success Manager to set up additional knowledge bases.

Even though this solution is available in search widgets only, it works in conjunction with auto-translation:

  • If there is an article in the user's language, then that is presented
  • If there is no relevant article, then the English KB is searched and the response is translated on-the-fly with Google Translate

To create a localized version of an article, do the following:

  1. In the AI Console, go to Knowledge > Articles.
  2. Open an article that you want to localize.
  3. On the Localization tab of the Article Editor, click Add localization.
  4. From the Choose KB drop-down list, select the knowledge base where you want to create the localized version of the selected article.
  5. Define the appropriate translation for the selected article:
    • On the Choose an existing answer tab, you can search for an article in the target knowledge base that contains the translation of your article (if you know there is such an article)
    • Otherwise, on the Write Answer tab, you can verify that the translation provided by Google Translate is correct
  6. On the Write Answer tab, add the necessary phrasings to the localized articles and make sure the article is Set Live.
  7. Save your changes.

    The Localization tab, now lists all localized versions of the article. The list includes the name of the user who last edited the localized article, the knowledge base that contains the localized article and the title of the article. Click View next to a localization to open the translated version of the article.

  8. Publish the original article to make the localized versions available.

The number of localized versions of an article is displayed on the Articles page:

What are the best practices for content creation?

Follow these guidelines about how to phrase intents and create article content to make the most of Bold360 AI's Natural Language Processing (NLP) algorithm.

When phrasing intents, keep in mind the following:

  • It?s best to phrase the intent as a question in natural language.
  • Bold360 AI?s NLP algorithm works best with questions that are three to eight words long.
  • Boring is good, so be consistent in how you formulate intents.
  • Use a single statement as intent, for example, What do I do if I can't log in? and avoid phrasings like What do I do if I cannot login, my password is rejected??. Add alternatives ways of asking about the same issue as phrasings to the article.
  • Avoid using acronyms and descriptions in titles like Is PayPal (PP) accepted?. Add synonyms for acronyms. Create phrasings for acronyms that are composed of three or more words.
  • Turn off autocomplete for articles like error messages and negative articles like I want to cancel by unselecting Search and Auto-Complete on the Visibility tab for the article.
    Note: You can also turn off autocomplete for phrasings if necessary.

When composing the answers, remember to:

  • Keep them short.
  • Engage readers using a variety of media: pictures, videos, gifs, tables and so on.
  • Use formatting options like bold, italics, underlining, bullets and so on.
  • Display content on multiple pages if needed; it is a good way to break up look articles to make them more digestible to the reader.
  • Take into consideration that the content may be consumed on a variety of interfaces: mobile, floating widget, support page and so on.
  • Create focused questions and answers and consider what the user really needs, for example, full user guide or steps on how to use the image button.
  • Use channeling instead of including phone numbers directly in the article answer body, especially when deflection from the phone channel is measured?.
  • Periodically revise your FAQs to keep suggested responses relevant.
  • Use conversational flows and article trees when you need more information from customer to provide an answer.
  • Use hyperlinks and ensure that the bot follows, or the link opens in a new tab:
    • Use when answering the question is best done by pointing to a page with a lot of information for user to explore.
    • Use when information is constantly changing and updates are made to that page rather than having to update the article.

How can I display long answers in multiple pages?

To present longer answers in a more digestible way, you can divide long articles into multiple pages.

With the Multiple page option of the Article Editor you can
  • Display longer articles in multiple pages in a Support Center
  • Display the content of an article in multiple pieces in a search widget
  • Display content in multiple bubbles in a conversational widget

You also have the option to delay the content that follows the first bubble in a conversational widget. Learn more here.

  1. In the Article Editor, choose (Multiple page) on the Content tab.

    Result: Page 1 appears above the text box and Add New Page appears below it.

  2. Create content for the first page.
  3. Select Add New Page and create the second part of the answer in the text box that appears.
  4. Add more pages and create content for them.
  5. Adjust your widget settings.
    • To display the content of this article in multiple pieces, make sure to use a chat widget that is set to Search widget mode.
    • To display the pages in multiple bubbles, make sure you use a chat widget that is set to Conversational widget mode.

When this article is displayed in a Support Center or in a search type widget, readers see only the content of the first page at first. They can navigate between the pages with the forward and backward arrows or select a page number to see the content of that page.

When this article is displayed in a conversational widget, the individual pages are presented in multiple bubbles.

How can I assign users to articles?

You can assign users to an article to signal that the article needs revision as part of the approval process.

To assign users to articles, you must have the Enable approval workflow option enabled for your account. Contact your Customer Success Manager to enable it for you. See How to define a content management workflow for more information.

Important: A user must have modify permission for Knowledge-Base to be included in the workflow.
  1. In the Bold360 AI, go to Knowledge > Articles.
  2. Create an article or open an existing one that you want to assign to a user.

    Result: The Article Editor is displayed.

  3. At the top of the Content tab, click New Assignee.
  4. Select a user from the list.

  5. Click Publish & Close.

Users can find all articles assigned to them under Knowledge > Assigned to Me.

You can also set up email alerts when the assignee changes. See How to receive email alerts about changes in an article to learn more.

What is letter count?

The letter count shows the number of characters with spaces in the given article.

Letter count is available for articles in the knowledge base as follows:

  • As a column in the article list under Knowledge Base > Articles
  • Above the Content area in the Article Editor

Why do I see N/A in the Letter Count column?

If the Letter Count column in the Article List shows N/A, the article in question uses conversational elements, like quick buttons, entities or has content on the Conversational tab. Therefore, the N/A value provides insight into which articles in the knowledge base contain such elements.

How can I tell if an article is linked from another article?

To find out whether an article is linked from another one is especially important before you delete an article. Every article in a knowledge base is uniquely identified by an ID, which serves as a link between articles.

To find the ID of an article, do the following:

All linked articles are listed.

  1. On the Knowledge > Articles page, click an article to open it. The ID is appended to the end of the link in your browser:

  2. Copy this ID and return to the Articles page.
  3. Search for the article ID that you have copied.
  4. Click the funnel icon next to the Search field.
  5. On the Options page, select Search title and answer body.
  6. Click Apply.

    All linked articles are listed.

How to use the widget preview in the Article Editor

The widget preview in the Article Editor allows you to view the article that you are creating directly in the editor while still working on the article.

Here?s what you should know about the widget preview:

  • You can select from the widget configurations available for the knowledge base using the drop-down right above the widget preview.
  • You can also select whether you want to see the selected configuration as defined for the floating, embedded or Advise widget.
  • The settings of the selected configuration are applied to the widget preview, that is, it looks like the real widget and displays the article as the real widget.
  • The preview widget supports conversations as well as search-based content. Whether the article appears as a conversation or as a simple article depends on the configuration of the selected widget.
  • The widget preview is available for Draft and Published articles alike.
  • Custom scripts and channeling policies are not applied to the widget preview.
To see the widget preview in the Article Editor, you must have the Enable widget preview in article editor (Beta) account setting enabled. Contact your Customer Success Manager to enable it for you.

Can I create new articles and save them as offline?

Yes. When you create a new article you can save it as offline before it is published. This allows you to set up internal processes for quality control before you add more content to your knowledge base, or finish your article editing later.

To save a new article as offline, click Save. The article will be available on the All Articles page. The article receives Offline and Never Published system labels.

See also How can I find draft articles?

How do I add a link to an image?

There are a couple of link types which you may add to an image.
  1. Add an image. For information on how to add an image, click here. If the image is already in the text, you may open the 'Image Properties' dialog by double clicking on the desired image.
  2. In the image dialog, click on the Link tab and fill in the desired URL address.
  3. Click the OK button to save the changes.

How can I add an attachment to an article?

Learn what types of attachments Bold360 AI supports and how to add them to an article.

To add a file to an answer, simply click on the attachment icon in the answer's toolbar.

A browser window will open for choosing your file.

These are the type of files which are supported as attachments in Bold360 AI (Knowledge base, Ticketing):

  • jpg
  • jpeg
  • png
  • gif
  • bmp
  • bml
  • tif
  • pdf
  • doc
  • docx
  • xls
  • xlm
  • xlsx
  • ppt
  • pptx
  • zip
  • rar
  • txt
  • xml
  • eml
  • pps
  • ppsx
  • rtf
  • csv
  • tar
  • gz
  • set
  • html
  • mobileconfig
  • apn
  • cs
  • aspx
  • mht
  • ged
  • uzed
  • zed
  • mp4
  • wav
  • mov
  • avi

In case you need to support additional attachment types, please contact our support team.

Please note, that the attachments are not supported in Bold360 AI conversational widgets.

How to create a button as a link in an article

In order to present a link as a button, copy the CSS below into the source of the article. In the snippet you will need to update:

  • The target link
  • The styling of the button
  • The text presented on the button

In order to generate the button's style you can also use widely available CSS Button generators.

<p><a href="https://www.Nanorep.com" 
style="background-color:#44c767; -moz-border-radius:28px; -webkit-border-radius:28px; border-radius:28px; 
border:1px solid #18ab29; display:inline-block; cursor:pointer; color:#ffffff; font-family:Arial; 
font-size:17px; padding:16px 31px; text-decoration:none; text-shadow:0px 1px 0px #2f6627 ;">green</a>
</p>

How do I create a translated article?

If you have knowledge bases in multiple languages, you can keep track of the article translation by linking it as a translated article.

Notice: The Knowledge Bases should be connected under the same translation group!

Linking Answers to Translations in Other Knowledge Bases

  1. Go to Knowledge > Articles and choose an article.
  2. Once the article editor opens, go to the Localization tab.
  3. Click Add Localization to connect the answer to a translated answer from a different Knowledge Base.

From the drop-down list, choose the Knowledge Base to connect the link to the answer. You have the following options:

  • If you already have a translated answer on the other knowledge-base, click Choose an existing answer and you can simply link to it (a suggested article will be shown).
  • If you do not have a translated answer in the other Knowledge Base, you can write a new one, click Write Answer. As a starting point, Bold360 AI will automatically translate the answer using Google Translator.

Indication of translated answers

On the Localization tab, you can view and edit all the translated articles that are connected to the article.

In the article list under Knowledge > Articles, you can view a column that indicates the number of languages each answer is translated to.

Can I offer a special response to a high-value question?

About high-value chats

Some questions may be more important to your organization than others, so you may want to handle them in a special way. These are called "high-value chats." If a customer asks a question you consider important, you can set Bold360 AI to push the user directly to chat, show a unique invitation, or collect data without offering a special response.

For example, you might know that users asking certain questions commonly convert at a higher rate or give a higher NPS score when they end up chatting with a real person. You should mark the articles associated with these questions as high-value. Here are a few questions commonly considered high-value: How do I upgrade? My [product] doesn't work! I'm having trouble submitting my order! I'd like to buy, but can't find the item!

High-value chat functionality is valid from any conversational touchpoint or from search as part of the Liveperson integration.

Setting up high-value chats

You can set any knowledge base article as high-value. Here's how to set an article's value and unique response:

  1. Create or select an article under Knowledge > Articles.
  2. Go to the article's Options tab.
  3. Under Channel Value, select how you want to respond when the user's intent matches this article:
    1. Low Value - Hide chat: Do not give the user the option to chat with a person.
    2. Normal Value: Show the answer and give the user the option to chat with a person.
    3. High Value: Show the answer and give the user the option to chat with a person. If the user chooses to chat, the engagement is reported as a high-value chat.
    4. High Value - show invitation: Same as High Value, but also show the user a special invitation. To edit the invitation, click Edit Invitation....
    5. High Value - Push chat: Send the user directly to a person without prompting. The engagement is reported as a high-value chat.
  4. Save and/or publish your changes.
Remember: High-value chat functionality is valid from any conversational touchpoint or from search as part of the Liveperson integration.

Viewing and analyzing data about high-value chats

To gain insight into how articles marked as high-value are performing, check the following locations:

  • Go to Analytics > Traffic and look for the High-Value Chats chart to see the percentage of user intents that matched articles set as high-value and were escalated to chat either by the user or automatically
  • Go to Analytics > Knowledge Base and look for the Popular High Value Chats chart to see articles marked as high-value that most frequently matched user intents and were escalated to chat either by the user or automatically

How to differentiate between positive and regular channeling for high-value chats

Positive channeling indicates intentional channeling. For example, when a specific intent indicates a customer is at risk and your strategy is to help this customer with a live agent. To add channeling value to an article, select High value for Channel Value on the Options tab in the Article Editor.

This impacts channeling statistics between high-value and regular channeling on the Dashboard.

Important: Channeled high-value interactions are still considered as unresolved from a self-service point of view. Therefore, the self-service score will be 0 for an interaction that was channeled from a high value article.

How can I add a new article to my Knowledge Base?

Use the Article Editor to create new content in your knowledge base.

  1. Open the Article Editor.
    • In the left navigation menu, click Knowledge > Add Article..
    • In the left navigation menu, click Knowledge > All articles, then click New Answer.
  2. Type a question in the Add title field and type the answer in the text editor.
  3. Save your article:
    • Click Save if you have not finished editing the article and you want to save an offline draft.
    • Click Publish to publish the new article in the Knowledge Base.
    • Click Publish & close to publish the new article and return to the All Articles page.

How to add notes to your article

You can add notes to an article if you want to add additional or internal information about the article itself. This may be useful when other content editors update your article.
Important: You must have the Enable article notes tab account setting enabled to see the Notes tab. Contact your Customer Success Manager to enable it for you.
  1. Open the article that you want to add notes to.

    You can only add notes to an existing article.

  2. In the Article Editor, go to the Notes tab.
  3. Type your remarks and click Publish when you are done.

    You can only add notes to the article itself and not to the individual article revisions.

How to add a table to an article

You have the option to present information in a table in the article's body.

To add a table to an answer, do the following:

  1. Click on the table icon in the toolbar.
  2. A browser window will open for choosing table properties.
  3. Configure the table properties, per your needs and click OK.

How do I add a link to a Bold360 AI answer?

To help your customers find related information, you can add links to other articles in your knowledge base.

  1. In the Article Editor, click on the (link) icon in the answer toolbar to open the Link dialog.
  2. On the Link Info tab, enter the text that you want to display as a link.
  3. Select Article from the Link Type drop-down.
  4. Optional: Select the Link to specific variation checkbox.

    When you create a link to an article with multiple variations, by default, Bold360 AI chooses the correct variation based on the context. This option enables you to create a link to a specific article variation yourself.

  5. In the Select an answer field, start typing the title of the article that you want to display once the link is clicked.

    Result: A list of matches is displayed.

  6. Select an article.

    If you selected the Link to specific variation checkbox, you can find and select a specific variation of an article.

Example:
 

For an example, we have created this link. Clicking it will direct you to the linked Bold360 AI answer.

How do synonyms work?

Synonyms are used to enhance your knowledge base and improve search results.

Synonyms that are considered for search across any of your Knowledge Bases (KB) consist of the following:

  • Local synonyms: The synonym repository in the KB which is created and maintained by your content management team. Local synonyms typically include words that are related to your business and serve as an extension to the list of global synonyms.
  • Global synonyms: Language-specific global synonyms that Bold360 AI uses which are relevant across all verticals. Global synonyms defined for the English KBs are listed below:
  • app, application
  • 1st, first
  • about, regard
  • basket, cart
  • ... and 170 others

It is important to note that there is a generic language thesaurus is much broader than the synonyms that are considered by Bold360 AI on a language level - either global or local.

Bold360 AI periodically updates the thesaurus used at the language level. When defining synonyms specific to your Knowledge Base, auto-suggestions are presented based on the general language corpus:

In addition, the search engine knows language morphology, which makes it smart enough to know that:

  • car = cars
  • child = children
  • really = real
  • etc.

Finally, the synonyms and NLP algorithm capabilities in Bold360 AI know how to deal with 'weak' words, such as "with", "what", "do", "can", and "can't", therefore you do not have to define these synonyms in your environment.

Note:
  • If you add these synonyms manually, it may reduce your performance in the Knowledge Base.
  • When a customer uses a synonym rather than the word that is present in an intent (article title), the intent matching score may be reduced.

The following is an example of global and local synonyms:

When you look at the synonyms of create, you see that "add" and "make" are defined locally. At the same time, "build" and "open" are defined as global synonyms that are also applied when a customer enters an intent.

What synonyms should I add to my Bold360 AI account?

You should add synonyms that are relevant to your business. For example, if your company sells electronics, you should add synonyms from the world of electronics:

  • Amplifier, receiver, power supply
  • Surround, stereo, speakers
  • TV, LED, 3D

Synonyms are not a transitory property, therefore you can define two different synonym groups where the same term would appear, but its synonyms would not be considered across groups. For instance group I: schedule = book; group II: book = notebook.

  • If an incoming search includes the word schedule, it would consider intents that include book, but not those that include notebook.
  • If an incoming search includes the word book it would consider intents that include both schedule and notebook.

As the Bold360 AI NLP has a built-in set of morphology tools, there is no need to capture synonyms to address the following:

  • compounds, such as "mymusic" and "my music"
  • use of punctuation, such as dashes (e.g. "my-music" and "my music")
  • typos
  • different tenses (e.g. "run" and "running"). However, you must associate a specific tense to a group of synonyms ("broke" with "poor", and "no money").

It is important to note that the use of synonyms by Bold360 AI's NLP may impact search results, because when you replace a term in the user's query with a synonym, the matching score is slightly reduced.

What are phrasings?

Phrasings are alternative ways of expressing the same intent.

Sometimes one answer is suitable for various questions. Take the following example:

Answer: "To see more details, log in with your user name and password"

  • Question 1: "How do I see my account details?"
  • Question 2: "Where can I find my balance?"

You don't need to worry about that! Bold360 AI automatically learns additional phrasings to existing questions and does the thinking for you.

However, if you have additional phrasings in mind and you want to accelerate the learning process and optimize your contextual answers system, you can manually add additional phrasings to an existing Q&A.

The original Q&A will still remain the same and visible to your users. All you do is teach the knowledge base system to recognize other questions and give them the same answer.

How to add phrasings to an article

  1. Go to Knowledge > Articles.
  2. Find the article you want to add a phrasing to and open it for editing.
  3. Choose Phrasings next to the title of the article.
  4. Enter a new phrasing and select Add.
  5. Publish the article.

How to create a linked article tree for multi-level answers

A linked article tree helps customers move through a series of related chunks of information until they get the answer they are looking for.

Linked articles are particularly useful for technical and troubleshooting questions. Customers ask their initial question and are presented with a list of options. The direction the article tree takes, and the eventual answer depend on the customer's choices.

In your knowledge base, articles that have links to other articles are labeled as Linked.

When you open such an article, you can see its linked articles on the Visibility tab of the Article Editor. To see all article trees in your knowledge base, in the Bold360 AI platform, go to Knowledge > Article Trees.

Follow the steps below to create an article tree.

  1. Create an article for the initial question.

    This should consist of the title representing the initial question and a series of answer options. Each option becomes a separate answer chain.

    Example: For example, you could create the following article:

    Title: My mobile phone is not working.

    Answer: What kind of mobile phone do you have?

    1. iPhone
    2. Android
  2. Create the subsequent answers in the chain for each previous answer option.

    Every answer is a separate article.

    Example: For example, you could create the following articles:

    1. For customers on iPhone, create the following article:

      Title: What iPhone model do you have?

      Answers:

      1. iPhone 7+ / iPhone 7
      2. iPhone 6+ / iPhone 6
      3. iPhone 5 / iPhone 5S
    2. For customers on Android, create the following article:

      Title: What model of Android phone do you have?

      Answers:

      1. Samsung
      2. HTC
  3. For each of the above answer options, write an accurate response.

    In this example, once the manufacturer and model are selected, the relevant answer can be displayed.

  4. Link the articles.

How to set the context in an iframe support center

In order to set the context, add a js function to your hosting page:

<script>
function setContextNanorepSupportPage(){
  return "< context Type >=< context Value >"
}
< /script >
Important: Remove the context from the iframe src if it was set there. For example:
<script>
function setContextNanorepSupportPage(){
  return "Device=Mobile"
}
< /script >

How do I search for text inside answers

You can change the behavior of the search in th Article List to also search in article bodies instead of just their titles.

  1. Go to the knowledge > All articles.
  2. Click on the funnel button.
  3. Click Options.
  4. Select the "Search titles and answer " field.
  5. Click Apply.
  6. Now you can write the keyword in the search box and get results regarding keywords inside answers.

How can I search by a label?

Labels assigned to knowledge base articles or tickets enable you to find related articles or tickets.

  1. Go to Knowledge > Articles to search the knowledge base or go to Ticketing > All tickets to search tickets.
  2. In the search field, enter the name of the label.
  3. Once you enter the label name, the system will then display the labeled option to click on.
  4. Click the Labeled option to activate the search filter.

You can define multiple labels to filter for in the Knowledge Base. To do so, on the Knowledge > Articles page, search for a label. Then perform another search for the next label, and so on. Only those articles will be listed that have all labels applied.

You can remove filters one by one by clicking Clear next to the unnecessary filter.

What are 'Expire On' / 'Publish On' system labels?

These system labels enable you to filter for articles with an expiration or publishing date in the article list in Bold360 AI.

This system label will allow you to easily track or filter articles that have expired/ planned to expire or planned to go live. According to the article definitions.



To set an expire/publish date go to All Articles, enter the article you wish to make the change.

Go to Options tab > Publish on or Answer expires on.


How do I remove a label from an article?

Remove labels from articles to remove the article from a group.

  1. Go to Knowledge > All Articles.
  2. You can remove labels from articles in the All Articles list or in the Article Editor.
    • To remove all labels from an article in the All Articles list, select the checkbox for the article, choose and select Clear labels. Confirm that you want to remove all labels from the article.
    • To remove labels one by one from an article in the Article Editor, open the article for editing and in the New Label field remove the labels using the x next to the label. Publish the article.

How to rearrange Quick Action buttons

You can drag-and-drop Quick Action and Persistent List buttons at the bottom of the Article Editor to change the order of the quick option buttons. By reorganizing buttons, you can easily drive customers' attention to the action that you prefer most.

How do I add a link to an answer?

You can add a URL to the body of an answer and present it as a URL or as clickable text.

  1. Select the desired text and then click on the "Link" icon in the toolbar. You may also click on the link icon without selecting any text. In that case, you'd be adding a direct URL address.
  2. In the link dialog, enter the target URL.
  3. Click OK to add the link.

How to add a "Click-to-Call" link to an article

A click-to-call button allows customers to call your support number quicker.

  1. Create a new article in your knowledge base, or use an existing article to add the Click-to-Call link.
  2. In the article editor, click the link button .
  3. In the pop-up window, under Protocol, choose <other>.
  4. In the URL field, enter tel://1800-000-000.
  5. Click OK.
The phone number link should now be clickable.
Example:

If you have Skype installed on your workstation, when you click on the link Skype will open and dial that number.

How can I find draft articles?

Articles that have never been published receive the Never Published system label and published articles that contain unpublished changes receive a (Draft) prefix in the Article List.

  • To find articles in draft mode:
    1. Go to Knowledge > All Articles.
    2. At the Search bar write Draft and choose Status Draft.

    Example:

  • To find articles in Never published mode:
    1. Go to Knowledge > All Articles.
    2. At the Search bar write Never Published and choose the system label Never Published.

    Example:

Why do I see different formatting in answers?

The Bold360 AI editor keeps the original text formatting when copying text and pasting it into the answer editor box.

You can remove text formatting by selecting the text and clicking Remove Format () in the toolobar.

Alternatively, you can click Source. Check the source code of the article to see if there are any unnecessary inline styles. This may be the result of copy/pasting content from a website or a document that contains formatting.

How do I import FAQ from a Website?

Import an existing FAQ from your website to jump start content creation in Bold360 AI.

Before you begin:

Before you import your FAQ into the Bold360 AIKnowledge Base, make sure that the FAQ page is built of questions and answers in a logical structure. For example, you can add your questions in HTML heading tags and your answers in paragraphs. You can also use paragraphs only and bold your questions so that the import process can differentiate questions from answers. You can find an example of a well-structured FAQ at https://www.amazon.com/gp/help/customer/display.html?nodeId=201995060.

Important:
  • Only articles from a single FAQ page can be imported. FAQs where every article is on an individual page cannot be imported. For this reason, if you have an FAQ similar to that of Twitter or YouTube, you will not be able to import articles.
  • You must type a valid URL which contains your FAQs. You cannot use a link that redirects readers to a different page.

To import your FAQ into the Bold360 AI Knowledge Base, do the following:

  1. In the Bold360 AI platform, go to Knowledge > Import FAQ.
  2. Enter the address of your FAQ website and click Go. The list of FAQ articles are listed with question titles and bodies.
  3. Optionally, select context values from the drop-down lists at the top of the list.

    All imported articles will have the selected contexts added.

  4. Optionally, click Edit on the right side of the question that you want to modify.

    Besides updating the content of the article, you can assign unique contexts that are applied to this article only.

  5. Once you have finished editing the articles, click Add selected articles to the knowledge base to upload them to your Knowledge Base.

Here is an example of importing FAQ articles from a website:

How can I find and replace a text in all articles

You can easily find and replace a text within all articles in the knowledge base using the Find and Replace option.

Important: This feature replaces all instances of the defined text in the HTML source of the articles. If you use HTML attributes or inline styles that include the defined text, then those will also be replaced.
  1. In the Bold360 AI platform, go to Knowledge > All Articles.
  2. Click the dotted button on the menu bar.
  3. Click Find and replace.

  4. Enter the search term in the Find field, and the text to replace it with in the Replace field.
  5. Click Go.

How do I modify a label's name?

Use the Edit option that appears next to a label in the Label List to change the details of the label.

  1. Access the label list.
  2. Choose a label.
  3. Click to edit it.
  4. Change the label name, color, or other characteristics as required and save.

When you change a label's name, all assigned labels are updated accordingly.


How can I add a YouTube or other video to an article?

To add a video to an article, first add it to an online video library that supports embedding and embed it in the body of the article.

To add a YouTube video to an article, do the following:

Note: These instructions are applicable to any online video library that supports embedding, such as Vimeo.
  1. Go to the video page on YouTube.
  2. Click Share under the video.
  3. Click Embed.
  4. Change the size of the embedded video in the generated script by changing the iframe's width parameter to 295 and the height parameter to 166.
  5. Copy the script.
  6. In the Article Editor, click Source in the article's toolbar to edit the answer's HTML source.
  7. Paste the YouTube script to the source.
  8. Click Source once again to go back to the regular mode.
  9. You can now add additional content to the article.

How can I control the visibility of answers?

You can control who can see an article in Bold360 AI and you can also define the touchpoints on which the article is visible.

As a content manager, you may want to limit the access to specific content for a variety of purposes:

  • You may want to make the information available only via a support page, where there is enough space to display rich content.
  • The information has business sensitivity, such as closing an account. While offering this article via search for users who explicitly look for this information, you may not want to expose it via navigation and FAQ.
  • There may be content that should be available to agents when replying to Bold360 AI tickets but unavailable to external users.

You can set article visibility on the Visibility tab of the Article Editor. By default, an article is visible in all touchpoints. To make it unavailable in a specific touchpoint, deselect that touchpoint. If you want to keep an article in your knowledge base, but not display it at all, turn it offline.

You have the following visibility options:

  • Search and Auto-Complete - Article is available in search based widget
  • Support Center - Article is available in support center
  • FAQ Widget - article is available for use in FAQ
  • Links from other articles - article is available for use as linked answer
  • Ticketing agent interface - Article is available an answer when replying to tickets in the Ticketing > Open tickets menu
  • Conversational - Article is available in conversational based widget

When replying to open tickets

You can reply to open tickets in the Ticketing > Open tickets menu. The name of the touchpoint where the article is available as an answer is displayed in the top-right corner of the answer as follows:

  • If the answer is available only when you answer an open ticket, a red "Agent Only" label is displayed
  • If the answer is available only in some of the touchpoints, then labels with these tocuhpoints will be presented, offering the agents an insight into why the user has escalated their request
  • If the answer is available in all touchpoints then no special indication is displayed

Assign group permissions for articles

You can define permission groups to make an article accessible to only a certain group of users in Bold360 AI. By doing so, you can essentially assign content managers to specific content types who will not see each other's articles.

Important: This feature is disabled by default. To enable it for a specific account, go to the Account Setup page and select the Beta Account Features > Enable users groups permissions option. Contact your Customer Success representative for further information

To add a user to a permission group, do the following:

  1. In the Bold360 AI platform, go to Admin Center > Users and click on the name of a user.
  2. Click the Permission Groups icon at the top of the page:
  3. Click Create group.
  4. Name your group and make sure you select the right Knowledge Base where you want to associate your articles with permission groups.
  5. Click Save.
  6. Click the name of a user to edit it and click Permission Groups at the top of the page.
  7. Make the user the member of a permission group by selecting a group. On the user details page, you see the associated permission groups in the Member of field.

Once you are done, you must also assign articles to permission groups:

  1. Go to Knowledge > Articles and select an article.
  2. On the Options tab, select the Permission Groups that you want to assign to the article.
  3. Publish and close the article.
Note: You must add articles one-by-one to a permission group.

Once you are done, only users in the proper permission groups will see the article.

How are unpublished answers shown?

Articles that have never been published receive the Never Published system label in the Article List.

If you edit an answer and save it instead of publishing right away, it is saved as Draft. You can resume editing your draft any time. Saving an article as draft does not affect your widget as it will still provide the version of the article before you drafted your changes.

You can keep an article in Draft status for as long as you want, but you must publish it to be presented as an answer to customers' questions. If a draft has never been published, it also receives a Never Published label.

To publish an answer, do the following:
  1. In the Bold360 AI platform, go to Knowledge > Articles.
  2. Click the answer that you want to publish.
  3. In the Article Editor, make sure the content satisfies your customers' needs.
  4. Click Publish.

How can I find answers with links/images in my knowledge-base?

You can customize the filter in the Article List so that the search returns articles with links or images.

To find answers that contain hyperlinks in your knowledge-base, do the following:
  1. Go to Knowledge > All Articles.
  2. Click the Filter button next to the search field.
  3. On the Options tab, select Search titles and answer body.
  4. Click Apply.
  5. Search for an article:
    • To search for links, type "href" in the search field and press Enter.
    • To search for images, type "img " in the search field and press Enter.

How can I filter articles by label?

Use labels to find articles related to the same topic.

Once you have created labels and assigned them to articles, you can use them to filter the list of articles by label.

  1. Go to Knowledge > All Articles.
  2. In the search field, start entering the name of the label.

    As you enter the label name, the system displays it with the labeled pretag.

  3. Select the Labeled <label name> option to activate the search filter.
The system returns a lit of articles that have the selected label assigned.

How to set the article expiration date

You can set an expiration date for an answer if it is only valid for a certain period.

  1. Open the article.
  2. Go to the Options tab.
  3. Fill in the expiration date in the Answer expires on field.
  4. In the When this item expires drop-down list, select what happens to the article when it expires:
    • Label it as 'Expired'
    • Label and set to Offline
    • Delete it
  5. Click Save.

How to set up an anchor link

An anchor link is a link on a page that brings you to a specific place on that page. Anchor links can be helpful when you want to bring a customer to a specific spot in an article.

  1. Set up your anchor points.
    1. Highlight the text where you want your anchor point to be and click the Anchor icon.

      Result: You will be prompted to give your anchor a name.

    2. Repeat this step to set up all your anchor points.
  2. Link your anchor points (for example in table of content).
    1. Highlight your link description and click on the link icon.
    2. In the Link box, under Link Type choose Link to anchor in the text.
    3. Under Select an Anchor select your anchor points by Anchor Name or by Element ID and click OK.

When was an article created?

The Revisions tab in the Article Editor gives you information about when an article was created as well as when and how it was changed.

To see when the article was created, do the following:

  1. On the Knowledge > Articles page, select an article.
  2. On the Revisions tab, check when the first revision was created.

The biggest hurdle with artificial intelligence is building a repository of answers for the AI to draw from. But with Bold360, building that knowledge base is faster and easier than ever. Existing FAQs can easily be imported, and our clean and simple interface makes it easy for any business user to create new articles from scratch. With Bold360, building your knowledge base is quick and painless, so AI can start helping right away.

Can I add images and animations to answers?

Yes, you can. Bold360 ai fully supports all HTML-based embedded content, including YouTube videos, Flash animations and much more.

Click here to learn more about adding an image to an answer.

Click here to learn more about adding a YouTube video to an answer.

How to create an image gallery

How can I add labels to articles?

Add labels to articles to group related articles together.

Once you have created labels, you can assign them to articles.

  1. Go to Knowledge > All Articles.
  2. You can add labels to articles in the All Articles list or in the Article Editor.
    • To add a label to an article in the All Articles list, select the checkbox for the article and then choose and select the label you want to assign. To assign multiple labels at once, choose Select multiple... in the label menu, select the labels to assign and choose Apply.
      Tip: You can assign labels to multiple articles with this option.
    • To add labels to an article in the Article Editor, open the article for editing and select the labels you want to assign in the New Label field. Publish the article.

How to create labels

Create labels to organize content in your knowledge base and group articles in the support center.

  1. Go to Knowledge > All Articles, and choose (Label).

    Result: In the drop down list displayed, you can see existing labels, and three links, including the Create Label link.

  2. Select the Create Label link.

    Result: The Label Editor is displayed.

  3. In the Label Editor, enter a name for the label and customize the look of the label.
  4. Choose Save to create the label.
The label is now be displayed in the list labels and when assigned to an article, it is displayed next to the article in the All Articles list.
You can now assign this label to articles and use it in the support center as well.

How do I create an HTML link to a Bold360 AI article?

You can create Direct Links to other Bold360 AI articles on your website, in e-mails, or anywhere else.

To add a link to another article:

Option #1

  1. In the Support Center, open the article that you want to link to.
  2. Click open a new tab .
  3. Copy the URL of the article from your browser.
  4. Paste the link to the article where you want to show this link.

Option #2

  1. In the Support Center, open the article that you want to link to.
  2. Click Share this answer .
  3. Click Copy to clipboard.
  4. Paste the link to the article where you want to show this link.

What are the best practices for managing a knowledge base?

Follow these best practices and guidelines to build a knowledge base that knowledge base managers can work with efficiently and where customers can find answers to their questions with ease.

Bold360 AI offers various options you can use to optimize your content:

  • Links to connect related articles to each other for easier findability
  • Labels to organize content in your knowledge base and group articles in the support center
  • Phrasings to make sure readers find relevant content when they use wordings other than the intent
  • Synonyms to cover similar words thus minimize the number of phrasings
  • Context to keep internal and external content separate, offer different escalation channel options based on customer type and so on
  • Article variations to create alternative answers to the same question for different audiences
  • User groups and permissions to provide access to a specific knowledge base or a subset of one
  • Content management workflow to ensure the quality of the content
  • Search Optimizer to help knowledge base managers follow up on customer voices and improve content and phrasings

What are the best practices for labels?

You can increase productivity using labels because you can save time looking for content. Organizing the content helps to keep the content grouped together per owner which in turn also creates easy accountability when filtering the reporting data by label.

When creating and applying labels to articles, keep in mind the following:

  • It?s best to use labels based on how you group content and assign content-related tasks internally.
  • It?s good practice to use a label for conversational articles and articles that include videos to easily find them.
  • To have control over what articles are presented in the FAQ, use a specific label for FAQ articles.
  • To create channeling policies and reports for certain articles, use the same label for them.

What are the best practices for phrasings?

When creating phrasings, remember the following:

  • Search works best with phrasings that are
    • to the point
    • three to eight words long
    • simple sentences
    • formulated as a question
  • Use phrasings that are unique to a single article to ensure the accuracy of search results.
  • Increase variety in the wording of phrasings? as the search algorithm looks at the combinations of the different terms used across all phrases in the article.?
  • Use negative phrasings when you have articles with almost identical titles and substantially different content.
  • Use synonyms instead of phrasings to cover words that are close in meaning.
  • Add up to 10 phrasings for an article.
  • Use the full term in the title and add acronyms as phrasings.
  • Use entities to turn your data into smart chatbot conversations.
  • When leveraging voices to create new phrasings, clean up the voice, for example, remove typos, redundant words and shorten long sentences to improve the appearance of phrasings in autocomplete.?

What are the best practices for synonyms?

Keeping a large list of synonyms helps improve the Bold360 AI Natural Language Processing (NLP) algorithm.?

When creating synonyms, remember the following:

  • Use narrow synonyms. If a synonym is too broad, it negatively impacts search results and it is difficult to identify the root cause.?
  • There?s no need to capture typos as the NLP algorithm automatically corrects them.
  • Create synonym groups for common abbreviations of a word.
  • Add synonyms that are specific to your business.
  • Use synonyms for acronyms and word combinations of two or more words.

What is the Suggested Content section?

You can use the Suggested Content page to turn insights from agents into new answers.

You can find suggested content under Knowledge > Suggested Content.

With proper permission, users in your Bold360 AI account can review, edit, and publish suggested content as knowledge base articles.

Articles in this section are not online until published.

How can an agent using Bold360 AI's ticketing system suggest content?

Agents can propose suggested content from within the ticketing system when they reply to a ticket by selecting the Decide later option. Selecting this option will add the agent's answer under Knowledge > Suggested Content.

How can an agent suggest new content in the Bold360 Agent Workspace?

When you integrate Bold360 Agent and Bold360 AI, your agents can suggest their replies to customers as new articles from the Bold360 Agent Workspace using Smart Advisor. See What is Smart Advisor? for more information.

How to add an image to an answer

You can add an image from the web or from your local computer to the body of the article.

To add an image to an answer, do the following:
  1. Click the image icon in the toolbar of the Article Editor.

  2. Choose to either use an existing image on the web or upload an image from your computer:
    • To add an image from the web, enter the target URL in the URL dialog.
    • To upload an image from your computer, go the Upload tab of the Image Properties dialog and upload an image.

    You do not have to define the original size of the image as it is scaled to 100% automatically.

    To manually adjust the size of the image, define image Width and Height.

    Note: When you scale an image up or down, you can keep the image ratio by clicking the lock icon next to the width property.
  3. Click OK when you are done.
To learn how to add a link to an image, How do I add a link to an image?.

Can I add animations to answers?

Yes, you can. Bold360 AI fully supports all HTML-based embedded content, including YouTube videos, Flash animations and much more.

Click here to learn more about adding a YouTube video to an answer.

How to use custom entities

Use custom entities in Bold360 AI to gather information from your customers and use it to offer a personalized experience.

Make sure your widget is set to conversational. Learn more here.

You can also use custom entities as an auxiliary for API-based data source entities as they help collect the information required for the API and then trigger the API itself.

Instead of asking your customers to fill in a form, you can create a conversation to gather information about the customer. For example, you can set up a custom entity that asks for the customer's name and then include their name in articles. Here's how to do that:

  1. In the AI Console, go to Knowledge > Entities.
  2. Choose (Create Entity) in the top right to create a new entity.
  3. Select custom entity for entity type.
  4. Provide a name and optionally a description for your entity.

    The entity name can contain letters, numbers and underscores. Spaces are not allowed.

    You can use the description to give your entity a more meaningful name or description that helps you identify it later.

    Example: Name your entity UserDetails.

  5. Set the life cycle of the entity to Persistent.

    This way, the bot does not forget the user?s first name once they enter one.

    You can also a set a life cycle for the individual properties keeping in mind their life cycle can't be longer than the life cycle of the entire entity. See this article to learn more about how the different life cycle options work.

  6. Fill out the entities table.

    Example:

    Table 1. Property asking for customer's name
    Name Detect Bot Query ErrorMessage Life Cycle
    FirstName Text Hi, I'm your virtual assistant. What's your first name? N/A Persistent
    Note: Since it's not possible to validate text-type custom entity properties, you can't enable error messages for such properties.

    To learn more about the property options for custom entities, see this article.

  7. Save your changes.
  8. Now go to Knowledge > Articles.
  9. Create a new article or open an existing one and add the entity in the article's body.

    Example: Intent: I want to go to Greece for a vacation

    Body: ?Here are our current offers for you, [[UserDetails.FirstName]]:?

    <add options to the article>

  10. Publish the article.

When an article that uses the UserDetails entity is returned as a response, first the entity question is presented then the article is presented with the name they provided. If the conversation continues and the another article with this entity is returned as a response, the bot won't ask the question again, because the customer name is retained for the duration of the session, as defined by the persistent life cycle option.

How to lock an article

You can lock an article so that only you can edit it.

Note: You can only lock published articles. If you do not see the Lock article button, contact your Customer Success Manager to enable the Article lock feature for your account in the Bold360 AI platform.

Some articles can be of higher importance to your organization than others. You might want to ensure that changes in these articles cannot be done easily or set them up so that only specific user roles are able to make any changes.

  1. In the Bold360 AI platform, go to Knowledge > All Articles and select the article that you want to lock.
  2. In the article editor, go to the Visibilitytab.
  3. Click Lock article at the bottom of the page.
  4. Save your changes.

    Result: A locked icon will appear at the top right corner of your screen.

To unlock an article, first verify that the role you are assigned has permission or seniority to unlock articles. Then go to the article options, and click Unlock Article. If your user role is not allowed to unlock an article, you will not see the unlock button.

How to use the Article Editor

The Article Editor is your ultimate tool for creating content for your customers.

The Article Editor is your ultimate tool for creating content for your customers. It offers the following features:

  • Content tab - A content editor to create articles that the bot serves to your customers
  • Visibility tab - Visibility settings to manage where your article is displayed, when it automatically expires, and which users can access the article in your knowledge base. You can also view the list of articles linked from the current article.
  • Options tab - Set channel value. See Can I offer a special response to a high-value question?
  • Notes tab - Add notes to your article. See How to add notes to an article.
  • Revisions tab - View and revert to previous revisions of your article. See How to view or revert to previous article revisions.
  • Comments tab - View comments of end-users who use the Advise widget
  • Rejections tab - As part of the content management workflow, add rejection notes to the article. See How to define a content management workflow.
  • Save a draft version, publish or delete the article
  • Toggle the status of the article between online and offline by clicking Set Live

To create a new article, do the following:

  1. In the AI Console, open the Article Editor:
    • In the left navigation menu, click Knowledge > Add Article..
    • In the left navigation menu, click Knowledge > All articles, then click New Answer.
  2. Type a question in the Add title field and type the answer in the text editor.
  3. Save your article:
    • Click Save if you have not finished editing the article and you want to save an offline draft.
    • Click Publish to publish the new article in the Knowledge Base.
    • Click Publish & close to publish the new article and return to the All Articles page.

How to control the visibility of articles

As a content manager, you may want to limit the access to specific content for a variety of purposes:

  • You may want to make the information available only via a support page, where there is enough space to display rich content.
  • The information has business sensitivity, such as closing an account. While offering this article via search for users who explicitly look for this information, you may not want to expose it via navigation and FAQ.
  • There may be content that should be available to agents when replying to tickets but unavailable to external users.

You can set article visibility on the Visibility tab of the Article Editor. By default, an article is visible in all touchpoints. To make it unavailable in a specific touchpoint, deselect that touchpoint. If you want to keep an article in your knowledge base, but not display it at all, turn it offline.

Note: On the right side of the Visibility tab, You can see the articles that link to the currently selected one.
  1. Go to the Knowledge > Articles page in the AI Console and select the article that you want to modify.
  2. On the Visibility tab, select which touchpoints should display the article:
    • Search and Auto-Complete - article is available in search based widget
    • Support Center - article is available in support center
    • FAQ Widget - article is available for use in FAQ
    • Open in widget link -
    • Links from other articles - article is available for use as linked answer
    • Ticketing agent interface - article is available an answer when replying to tickets in the Ticketing > Open tickets menu. The name of the touchpoint where the article is available as an answer is displayed in the top-right corner of the answer as follows:
      • If the answer is available only when you answer an open ticket, a red "Agent Only" label is displayed
      • If the answer is available only in some of the touchpoints, then labels with these tocuhpoints will be presented, offering the agents an insight into why the user has escalated their request
      • If the answer is available in all touchpoints then no special indication is displayed
    • Do not index this article - search engines will not find the article
    • Show article in sitemap.xml - allows search engines to find the article, which is important for SEO purposes. By default, all articles are indexed.
    • Publish on - set a date to automatically publish the article on a future date
    • Expires on - set a date when the article should be unavailable for your customers. The article will be moved to the Knowledge > Expired menu.
    • Permission groups - see How to assign group permissions for articles
    • Lock article - lock the article so that only you can edit or delete it
  3. Publish the article.

How to assign group permissions for articles

You can define permission groups to make an article accessible to only a certain group of users in the AI Console. By doing so, you can essentially assign content managers to specific content types who will not see each other's articles.

Important: This feature is disabled by default. Contact your Customer Success representative for further information

To add a user to a permission group, do the following:

  1. In the AI Console, go to Admin Center > Users and click on the name of a user.
  2. Click the Permission Groups icon at the top of the page:

  3. Click Create group.
  4. Name your group and make sure you select the right Knowledge Base where you want to associate your articles with permission groups.
  5. Click Save.
  6. Click the name of a user to edit it and click Permission Groups at the top of the page.
  7. Make the user the member of a permission group by selecting a group. On the user details page, you see the associated permission groups in the Member of field.
  8. Once you are done, you must also assign articles to permission groups:
    1. Go to Knowledge > Articles and select an article.
    2. On the Options tab, select the Permission Groups that you want to assign to the article.
    3. Publish and close the article.
      Note: You must add articles one-by-one to a permission group.
Once you are done, only users in the proper permission groups will see the article.

How to view or revert to previous article revisions

You can view earlier revisions of an article to check what it previously looked like.
Note: You cannot compare two revisions in the Article Editor.
  1. Go to the Knowledge > Articles page in the AI Console and select an article.
  2. On the Revisions tab, select a version of the article that you want to view.

    The Content tab now displays the selected revision of the article.

  3. To revert to the selected revision, click the Revert to this revision link at the top of the Article Editor.
  4. Publish the article.

How to add notes to an article

You can add notes to an article when you want to provide additional information to other content editors. These notes are related to the article itself and not to the individual revisions.
  1. Go to the Knowledge > Articles page in Bold360 AI and select an article.
  2. On the Notes tab, add your remarks about the article.
  3. Publish the article.

How to style your content

You have the following options to display formatted content to your customers:
  • You can use a full range of fonts to style your article content:
    1. Select the text that you want to customize.
    2. From the Font Name menu, select a font face.
  • You can modify the list style type of bullet and numbered lists:
    1. Right-click the list that you want to modify.
    2. Depending on the list type, click Bulleted List Properties or Numbered List Properties.
    3. You can select the list style from a drop-down list.
  • You can add indentation to any HTML element in an article.

What about that warning about conflicting intents?

If a content manager attempts to add a new title or a new phrase that is similar to a phrase in a different article, a warning is displayed. The user is able to view the article that holds the similar phrase to determine if the two articles need to be consolidated or bypass the warning.

Important: Similar phrases in separate articles may negatively impact the NLP and therefore not recommended.

Announcements

Join the DX Community!

Meet fellow DX pros, ask questions, and learn best practices.

Join the DX Community

Featured

Configuring the Genesys DX Product Authentication Service as SSO service

This article provides a step-by-step process for configuring the Genesys DX Product Authentication Service as SSO Service.

  1. Set up your Identity Provider. Read more about setting up your Identity Provider in this article.
     
  2. Login to https://auth.bold360.com/ and click Go to SSO Setup in the bottom left corner.
    Note: If you cannot see the Go to SSO Setup button, contact your support representative or the Genesys CX support.


    You are then navigated to the SSO setup webpage.
    NoteGeneral Settings and Domain are read-only fields, you cannot modify them.
  3. Click Sign-in configuration, and enable the SSO.

     
  4. Choose one of the two configuration methods:

    Method 1: Manual Configuration


    Add your Verification Certificate when you are finished with manual configuration.

    When you add the Verification Certificate, remove the following tags:
    "-----BEGIN CERTIFICATE-----"
    "-----END CERTIFICATE-----"

    A Verification Certificate example with removed BEGIN and END tags: 


    Method 2: SAML IdP metadata URL

    Host your Identity Provider metadata XML file on a publicly accessible URL.


    Note: Since we cache this file for only 2 minutes, please ensure high availability of this file via the specified URL to avoid SSO login failures.
     
  5. Once you have setup your configuration using a method of your choice, save your changes and then click View test login page, where you can test the Single Sign-on login.

    Enter your email /username that uses the domain you have setup in your Identity Provider service and click Continue. You should see this message on a successful login.