Set up Community Helper

Community Helper is an entire team of support reps wrapped into a nifty bot. Once installed, it keeps looking for new threads that haven't been answered in time. Then, using its NLP analyzers, search capabilities, and built-in templates, it answers the original poster. An admin can set up the time Community Helper will wait before jumping in; from as 10 minutes to 3 days.

This article walks you through the installation and setting up of Community Helper.

NOTE.

Community Helper works only on Salesforce and Lithium communities.

An admin can set up one bot for each community.

Install Community Helper

  1. From main navigation, click Apps and then Install New App.

  2. Find Community Helper and install it.

If the installation was successful, a new tab will appear in the main navigation.

Create Your First Bot

  1. From main navigation, click Community Helper.

  2. An admin can create a new bot for each community. To start, click Add New Bot.

  3. Each bot has a label to help admins distinguish one from another. Give yours a label and click Continue.

  4. Check the community where the bot will work. Colubridae '20 supports two platforms: Salesforce and Lithium.

  5. Pick a search client and click Save to create the bot. Why should I choose a search client?ClosedAt the heart of a Community Bot are a language analyzer and a responder. The language analyzer finds out (as best as it can) what a new thread is about , extracts the keywords from the first post, and then sends them over the responder, which in turn, looks up those keywords in your content sources through the search client that you have selected.   

If bot creation was successful, then you should be able to see it on the Community Helper screen.

Authorize Yourself

The first step to authorizing your identity is to open edit settings which can be done by clicking .

Next, follow one of the following processes.

  1. Pick either Production or Sandbox in Client URL.

  2. Select OAuth in Authentication Method and click Connect.

  3. A dialog will open, asking you to log into your community. Sign in to authorize.

  4. On successful authorization, a dropdown will appear. Click on Choose Your Community.

  5. Select your community and save.

  1. Enter your community address in Client URL.

  2. Select either OAuth or HTAccess to authorize yourself. The first method requires a client ID and a client secret. The second method requires an SearchUnify admin to enter, besides a client ID and client secret, HTAccess username and HTAccess password.

  3. Click Connect.

  4. A dialog will open, asking you to log into your community. Sign in to authorize.

After authorization, you will be taken to a Download Endpoint screen.

Create an Endpoint

The instructions to creating an endpoint have been packaged in a text file which you can get by clicking Download.

Select Content Sources

The bot assists community users by suggesting them knowledge articles, solved threads, and other documents stored in your content sources. On the Content Source screen, an admin can define the scope of a bot's search, that is if the bot should look into all your content sources or only a select ones.

  1. Check all the content sources and content types you think your bot will need access to.

Compose Templates

  1. The first step in drafting a template is to decide when the bot should spring into action and publish a response. It can be decided on the Personalized Response screen in the Schedule Response section.

  2. Next, click Add New Template.

  3. A dialog will open. Enter the details to create a template.
    • Agent Name. Bot's name on the community. It will be visible to the community members.
    • Agent Email. Bot's email address on the community. It will be visible to the community members as well.
    • Designation. Bot's job profile on the community. It will be visible to the community members.
    • Create a Response. A text box where you can compose a template using response tags and response fields as placeholders. What are response tags?Closed The response tags are the properties of the top results the responder will find. In the image, you can see three properties: Response Title (a placeholder for the title of the first search result), Response URL(a placeholder for the web address of the first search result), and Summary (a placeholder the meta description of the first search result). Drag them to their place in your template. Check out "Why Should I Choose a Search Engine?" to learn what a responder is.  and What is a post field?ClosedThe post fields are the properties of your Lithium or Salesforce community and depend much on the set-up. Some communities might have only post fields while others can have up to 10. In the image are seven post fields: Title, Description, Parent Category, Created Date, Board, Author Name, and Tags. You can use one, two, or all of them.  
    • Template Name. A label for your template. It will help you distinguish when you have several of them.

  4. Save your template.

  5. OPTIONAL. Repeat the steps 1-4 to create more templates.

  6. Save your template(s).

  7. On the Community Manager screen, activate the bot.

Result

A community bot in action.

Last updated: Wednesday, September 20, 2023

Or, send us your review at help-feedback@searchunify.com