Skip to main content

Let chatters search your Zendesk or Salesforce knowledge base content

Overview

With Smart Search, your bot can use your knowledge base as a back up when it doesn't know the answer to a question. If it finds any article matches, your bot will share the links to the articles with the chatter. This is a great way to enhance the chatter experience, ensuring they get the answers they're looking for.

Requirements

  • Zendesk Guide or Salesforce Knowledge

  • Ada's Personalization package

How Smart Search works

Once you connect Smart Search to your help center, your bot syncs with your knowledge base and ingests the articles that exist there. By doing this, your bot can search the content of these articles to find the best match for any questions it doesn't have an Answer for. Up to three articles in order of relevance, depending on how many are a good match.

smartsearch_inchat.gif

How does Smart Search find articles?

Smart Search uses Ada's own search logic, and looks at both the article title and body content to find a match. Smart Search doesn't use labels or other search relevance data.

What if there are no article matches?

Chatters only see Smart Search results if there is at least one relevant article match to their question. If there are no article matches, your bot responds with the Not Understood Answer.

Does anything need to be done to prepare my help center?

No. Everything required for Smart Search to work is already built in.

Configure Smart Search

Smart Search configuration requirements vary, depending on the platform you are connecting. In this section, you'll find the instructions for setting up each of the supported platforms.

Smart Search is currently available for the following knowledge base platforms:

Smart Search for Salesforce Knowledge

Before you start the Smart Search for Salesforce configuration, take note of the following:

  • Create a Connected App – Salesforce allows external applications, like Smart Search, to connect to their platform using a special framework they call a connected app. You must create a connected app in Salesforce before you start the Smart Search configuration. To learn more about connected apps, including how to create one, visit the Salesforce connected app guide.

  • Use Rich Text Fields – Smart Search requires that your Salesforce knowledge base articles use Rich Text Fields. For more information about Rich Text Fields, see the Salesforce guide Rich Text Fields in Knowledge Articles.

  • Multilingual support – Smart Search can share your support articles in your chatter's language. Be sure to enable your supported languages in both your bot and your Salesforce knowledge base.

Do you have everything ready to go for connecting Smart Search to your Salesforce knowledge base? Then let's start!

Follow these steps:

  1. On the Ada dashboard, go to Settings > Integrations, then scroll down to the Smart Search Integrations section.

  2. On the Salesforce tile, click Configure. The Connect Salesforce Knowledge dialog box appears.

  3. In the Connect Salesforce Knowledge dialog box, under Salesforce Credentials, complete the configuration fields required to connect to your Salesforce account.

    Use the following table to learn more about each field:

    Instance URL

    This is the URL for your Salesforce account. Smart Search uses this to authenticate the connection.

    Example: https://YourDomain.my.salesforce.com

    For more information, read the Salesforce guide View instance information for your Salesforce Organization.

    Support URL

    This is the public URL for your Salesforce knowledge base and community site. This is the URL Smart Search uses to search and display articles.

    Example: https://YourKBDomain.salesforce.com

    Note

    Your Support URL can be either the same URL as your Instance URL, or a unique URL specific to your knowledge base. It just depends on your Salesforce platform's setup.

    If you do have more than one Support URL available, you can use only one of them for Smart Search at a time.

    Consumer Key

    This is a unique value that generates automatically when you create a Salesforce connected app.

    Note

    Consumer key is the Salesforce name for the OAuth 2.0 client_id.

    Consumer Secret

    This is an authentication token, generated automatically when you create a Salesforce connected app. Basically, it's the password that allows Smart Search to connect to Salesforce through your connected app.

    Note

    Consumer secret is the Salesforce name for the OAuth 2.0 client_secret.

    Tip

    Need to retrieve your Consumer Key and Consumer Secret? On the Salesforce dashboard, go to Setup > App Manager, locate your app in the list, click the drop-down arrow on the right, then click View to open your app details. You'll find your credentials under the API section.

  4. In the Connect Salesforce Knowledge dialog, copy the Ada Callback URL, then paste it in the Salesforce connected app's Callback URL field.

  5. Click Authenticate. A new browser window opens displaying the Salesforce login page.

  6. Log in to your Salesforce account. then in the Allow Access dialog box, click Allow to grant Smart Search access to your Salesforce knowledge base API. The Allow Access dialog box closes automatically.

You're done! You've successfully connected Smart Search to your Salesforce knowledge base.

Smart Search for Zendesk Guide

Connecting Ada to your Zendesk knowledge base couldn't be easier. You just need your Zendesk subdomain—add it to the Smart Search configuration in the Integrations view, and you're done!

Follow these steps:

  1. On the Ada dashboard, go to Settings > Integrations, then scroll down to the Smart Search Integrations section.

  2. On the Zendesk Guide tile, click Configure. The Connect Zendesk Guide dialog appears.

  3. In the Subdomain field, enter your Zendesk subdomain, then click Connect.

    subdomain_example.png

    Important

    Be sure you use your actual Zendesk subdomain, and not a custom domain name, to connect Smart Search. See Finding your Zendesk subdomain when using a custom domain for instructions about how to find your subdomain.

  4. A confirmation message displays in the dialog to indicate a successful connection. Click Go to Answer to open the Smart Search Answer.

  5. You can use Ada's default message, or you can customize the Smart Search Answer content as you see fit.

The connection between Smart Search and Zendesk Guide is complete. Now your bot can leverage your help center to make sure your chatters get the information they need.

Note

Once connected, it may take a few minutes for your bot to complete the initial sync with your knowledge base. Smart Search won't return articles until that sync is complete.

Finding your Zendesk subdomain when using a custom domain

If your organization uses a custom domain name for your help center URL and not the default Zendesk subdomain, you'll need to find your actual subdomain to complete the Smart Search configuration steps.

You can also use Google's DNS lookup tool:

  1. Go to the Google Dig tool.

  2. In the Name field, enter your help center's custom domain name. Include only the domain elements. Don't include the https://, or any pathways, slashes, etc.

    Example: Enter help.acustomdomain.com, not https://help.acustomdomain.com/

  3. In the list of options below the Name field, click CNAME. In the results field that appears, under Target, you'll find your full Zendesk URL containing your actual subdomain. You use this subdomain in step 3 of Configure Smart Search.

    google_dig_tool_with_avdomain.png

Disconnect Smart Search

If you want to stop your bot from searching for relevant help articles, you need to disconnect your knowledge base account from Smart Search. This is done with a click of a button.

  1. On the Ada dashboard, go to Settings > Integrations.

  2. Scroll down to Smart Search Integrations at the bottom of the page, then click Configure on the right of your platform's row. The Connect dialog box appears.

  3. Click Disconnect account, then click Disconnect.

You'll see a confirmation message at the bottom of the dashboard. From that point on, your bot will no longer search your help center for support articles.

Chatter experience

When asked a question for which the bot doesn't have an answer, but for which there are relevant knowledge base articles, the bot presents the chatter with a list of the articles that best relate to the question. The chatter can then select the article they think is the best match. The article opens in its own frame within the main Ada chat window.

Note

Smart Search won't trigger unless the question is composed of a minimum of four words, each of two letters or more.

  • The chatter asks a question.

  • The bot responds with the text added to the Smart Search Answer. This should indicate that the bot doesn't know the answer to the question directly, but has some articles that may be relevant.

  • The bot shares up to three articles which best match the chatter's question.

  • The chatter clicks the link to the article of their choice.

  • The article opens within the Ada chat window.

  • Once done with the article the chatter closes the article by clicking the X.

  • The article window closes, and can select another article, or continue chatting with your bot.

Have any questions? Contact your Ada team—or email us at help@ada.support.