On this page

Articles

Articles are pieces of information about your product or organization in a knowledge base that's used to answer customer queries with the help of Turing bot, customer portal, or PLuG.

Articles are associated with a part (product or service) and can be created by internal users. Your customers can search across your articles and serve themselves on their queries. This empowers your customers to find answers on their own instead of waiting for your support team to get back to them.

Articles can be found under Settings > Support > Knowledge base > Articles.

Create an article

  1. Go to Settings > Support > Knowledge base > Articles.

  2. You can create an article in the following ways:

    • Link an external URL.
    • Upload a document.
    • Write a new article with DevRev's rich text editor. Click Next.
      articles
  3. Fill in the following to get your article ready for publishing:

  4. Click Create.

You can also create articles automatically by using smart import KBs snap-in.

Status

  • Draft

    The article isn't ready to be released to the public. You can make edits at this stage.

  • Published

    The articles have already been released to the public.

  • Review needed

    Articles that need approval and to be reviewed by others before releasing them.

  • Archived

    Articles that are outdated and no longer required can be removed by archiving them.

Access

Give access to view the articles by selecting any one of the following:

  • Private

    • Not accessible to external users.
    • Not used to generate answers by the bot.
    • Only appear in search results within the app.
  • External

    • Accessible only to authenticated users.
    • Used by the Turing Bot to generate answers.
    • Cited as sources when the bot provides answers to authenticated external users.
    • Appear in search results on both the app (for internal users) and the portal (for only authenticated users).
  • Internal

    • Not accessible to external users.
    • Appear in search results on the app for internal users, but not searchable by external users.
  • Public

    • Accessible to all users on the portal, both authenticated and unauthenticated.
    • Used by the Turing bot to generate answers.
    • Cited as sources when the bot provides answers to users.
    • Appear in search results on both the app for internal users and the portal (for all external users).

Collections

Collections are the parent for articles in your Help Center. Parent helps you define the multi-level hierarchy of your directories. Keeping the parent as the home page creates a top-level collection for you. If you wish to organize this collection into some other directory then you can change the parent to the other directory you wish to organize it in. They organize your articles so people can browse your help content and find what they want.

You can nest as many collections inside a single collection giving a proper structure to your customer support portal and PLuG Widget by DevRev.

collections

Create a collection

To create a collection, go to Settings > Support > Article Collections and then click on +Collection from the top right corner of your screen. Fill in the following details to create your collection:

  • Title
  • Description
  • Parent

Edit collection

To edit your collection, go to Settings > Support > Article Collections and then click present next to the collection you want to edit. Click on Edit to edit the collection name, collection description, and the parent of that collection.

To delete your collection go to the article you want to delete, click next to it. Click Delete.

icon

You won't be able to delete a collection if there are items inside it.

Organize your hierarchy

In Article Collections you would be able to view your customer portal hierarchy where you can see all your parent collections with more collections and articles nested inside it. You can also drag & drop your nested hierarchy to define the order in which your customers can see your collections and articles inside it.

Assign articles to collections

You can assign your articles to your collections in the following ways:

  • Go to Settings > Knowledge Base and open the article and then change the Collection attribute for that article. The Collection attribute gives you a list of all the collections that you have created and you can select any one of them.
  • Go to Settings > Articles Collection and then click +Add which is present next to the collection that you have created. You can search all the articles that you have created and multi-select the list of articles you wish to add to the specific collection.
icon

An article can be a part of only one collection.

Help Center

Help Center makes your articles and collections visible on your customer portal. Customers can browse through necessary information in the customer portal. You can go to Settings > Portal settings and enable Help Center. Ensure that a collection already exists before enabling this option. Create a collection if it does not exist.