Integrate Salesforce knowledgebase with Amazon Connect Wisdom

Today’s end-user expects speedy and personalized customer service and does not wish to spend time waiting on a call while an agent is searching for information about the case.

When customer service agents need access to information to assist a customer, they lose time trying to navigate various data sources in silos: frequently asked questions, files, wiki pages, call histories, knowledge bases, etc.

Companies using Salesforce build their Salesforce knowledge base using knowledge articles. A knowledge article is a document that provides information, such as a how-to on how to reset your password, or a frequently asked question on the location of the closest store and hours of operation.
The articles are usually written by experienced service agents and internal writers and can both be used internally and externally. With these knowledge repositories connected with Amazon Connect Wisdom, agents can quickly find answers and solve customer issues. In addition to improving customer satisfaction, this could assist in reducing agents’ time spent looking for answers and reduce average call handling time. Customers can also use Amazon Connect CTI Adapter to integrate Amazon Connect with Salesforce Service Cloud to build innovative customer experiences and Amazon Connect CTI Adapter allows for integration with Amazon Connect Wisdom.

This blog post shows how you can provide agents access to knowledge repositories in Salesforce using Amazon Connect Wisdom.

Overview of Amazon Connect Wisdom

Amazon Connect Wisdom, a feature of Amazon Connect, delivers agents the information they need, reducing the time spent searching for answers.

Amazon Connect Wisdom can enable customers even further, by using connectors for third party application including Salesforce and ServiceNow that allow you to ingest content from their knowledge stores.
Additionally, when used with Contact Lens for Amazon Connect, Amazon Connect Wisdom leverages machine learning powered speech analytics to automatically detect customer issues during calls and then recommend content in real-time to help resolve the issue, so that agents don’t have to manually search knowledge articles.

All of these features enable agents with the information they need to resolve customer issues as quickly as possible.

Solution Overview

AnyCompany has been using Amazon Connect and Salesforce for the agent day-to-day CRM tasks and Salesforce Knowledge for storing knowledge base articles that are commonly used for customer troubleshooting. Their agents regularly spend time looking for knowledge documents stored in Salesforce and other repositories, which requires them to move between different clients, prolonging the call with the customer. In this blog, we’ll cover the steps required to integrate Amazon Connect Wisdom with Salesforce Knowledge for providing agents with both the ability to search for any known Salesforce Knowledge base articles and real-time recommendations within their Amazon Connect agent application.

There are two ways you can enable Amazon Connect Wisdom for your Amazon Connect instance:

  1. Use the new Amazon Connect console.
  2. Use the Amazon Connect Wisdom API. You can ingest content using the Amazon Connect Wisdom APIs. The APIs support the ingestion of HTML and text; plain text files must be in UTF-8.

In this solution, we use the Amazon Connect Console for creating the integration between Salesforce and Amazon Connect Wisdom.

Solution Architecture


To deploy the solution, you will complete the following steps:

  1. Setup Integration between Amazon Connect Wisdom and Salesforce.
  2. Configure sync frequency and objects to be imported.
  3. Enable Contact Lens for Amazon Connect and create a custom contact flow for real time recommendations.


To deploy the solution, the following components needs to have been setup first:

Configuring Amazon Connect Wisdom for Agent search

The next steps will enable us to configure our Amazon Connect Instance and setup integration between Amazon Connect Wisdom and Salesforce. The integration, will allow agents to manually search known Salesforce knowledge-based articles through their Amazon Connect Agent Web app.

Add integration

Following are instructions for how to create a new domain and add an integration.

  1. Open the Amazon Connect console at
  2. On the instances page, choose the instance alias. The instance alias is also your instance name, which appears in your Amazon Connect URL.
  3. In the navigation pane, choose Wisdom, and then choose Add domain.
  4. On the Add domain page, choose Create a domain.
  5. In the Domain name box, enter a friendly name that’s meaningful to you, such as your organization name, for example, Wisdom-AnyCompany.
  6. Under Encryption, create or enter your own AWS KMS key for encrypting your Wisdom domain.
  7. Choose Add domain.
  8. On the Wisdom page, choose Add integration.
  9. On the Add integration page, choose Create a new integration, and then select the source as Salesforce.
  10. In the Integration name box, assign a friendly name to the integration, one that is meaningful to you and select all the fields to verify you have access to Salesforce.
  11. Under Connection with Salesforce, choose Create a new connection, and then enter a friendly name for the connection that is meaningful to you.
  12. Enter the Salesforce instance URL of the source you want to connect to, select the type of the Salesforce environment (Production / Sandbox), and then choose Log in to Salesforce.
  13. On the Prompted screen, provide your Salesforce credentials using the account enable for API access and allow access to connect to Salesforce.
  14. Upon successful connection, the following prompt should appear on the screen:
  15. Under Encryption, choose an existing KMS key or Create an AWS KMS key. This key encrypts the connection to the external application that stores content.
  16. Under Sync frequency, the default is hourly. You can use the dropdown to choose Every 3 hours or Daily. On-demand syncing is not available.
  17. Under Ingestion start date, choose when you want Wisdom to import records from your application, and how often.
  18. Choose Next.

Select object and fields

As a next step you choose the object and fields from the source that you want to make available to your agents in Wisdom.

  1. In the Available objects dropdown menu, choose the object you want. Only knowledge objects appear in the menu.
  2. Under Select Fields for Knowledge__kav, choose the fields you want to include. You’ll notice that some fields, such as ArticleNumber and ID, are already selected by default. These fields are required.
    • Article Number
    • ID
    • IsDeleted
    • PublishStatus
    • Title
    • Version Number
    • Answer
    • Question
  3. Choose Next.

Review and integrate

  1. Review all the integration details.
  2. Choose Add integration.
  3. The integration is added to your list, as shown in the following example.

Test Agent manual search

  1. Have your agent login to their agent application using https://[Connect-Instance-URL] with their username and password.
  2. View the new the new Wisdom search bar on the top right, which provides the agent the ability to manually search for knowledgebase articles.
  3. To perform a manual search, type the Knowledge article or question you would like to search for:
  4. Open the matching knowledgebase articles results to view them on the main agent screen.

After configuring Amazon Connect Wisdom for agent search, AnyCompany agents are able to perform manual search across their Salesforce Knowledge instance from within their Amazon Connect agent application.

Next, we’ll configure the real-time recommendations, where Wisdom uses real-time call transcripts from Contact Lens for Amazon Connect to automatically detect customer issues during calls to recommend relevant content stored across connected knowledge repositories. Agents can also manually search for information to solve customer requests.

Configuring Amazon Connect Wisdom for real-time recommendation:

Add a Wisdom block to your contact flow

  1. Log in to your Amazon Connect Instance.
  2. Choose Contact Flows from the Routing menu.
  3. Create a new Contact Flow and Add the Wisdom Block to the flow or download the following example contact flow and import as a new contact flow.
    [Download Contact Flow]
    For more information on how to import contact flow, use the following article.
  4. Verify that your Contact Flow has configured the Contact Lens block for real-time and post-call analytics to support real-time recommendation for Wisdom:
  5. Configure the Wisdom block and select the Integration created earlier:
  6. Save and Publish your Contact flow.
  7. Assign a Phone Number to your Contact flow.

Test Agent real-time recommendation

  1. Have your agent log in into the agent application console at: https://[Connect-Instance-URL] with their username and password.
  2. As the Agent logged in, you’ll notice a new Search Bar at the top right for the Wisdom Integration.
  3. Place a call to the phone number configured earlier, and report an issue or a problem you are having.
  4. Real-time Recommendations, perform the search based on the customer conversation while Amazon Connect analyses and identifies if there is an issue in the call where an existing knowledge base can help address the issue raised by the customer.
  5. As Contact Lens performs the real-time analysis of the conversation, it automatically identifies issues, which are sent to Wisdom to perform the real-time suggestions. If the Issues identified have a result in the Salesforce Knowledge base, the search toolbar will have a green bar showing the following suggested options:

After completing this step, AnyCompany agents can get real-time recommendations from their Salesforce Knowledge articles based on real-time analysis provided by Contact Lens.

With the Wisdom setup in Amazon Connect completed, you can follow the instructions here to integrate Amazon Connect Wisdom with the Amazon Connect CTI Adaptor (if you are using Amazon Connect CTI adaptor).


In this post, we walked through how to use Amazon Connect Wisdom and how to integrate it with an external connector to give agents easier access to the information they need to solve customer issues. Specifically, we learned how to create the integration with Salesforce Knowledge, setting up the sync frequency and fields, and provide the agents with the ability to manually search for content or provide them with real-time recommendations by leveraging Amazon Connect Contact Lens. With Amazon Connect Wisdom, contact center agents have the information they need to deliver faster customer service leading to higher customer satisfaction.

Get started with using Amazon Connect Wisdom and integrate it with your connector of choice to provide real-time recommendations and search functionality to your agents today.

Guy Bachar

Guy Bachar

Guy Bachar is a Solution Architect at AWS, based in New York. He accompanies greenfield customers and helps them get started on their cloud journey with AWS. He is passionate about Identity, Security and unified communications.

Birender Pal

Birender Pal

Birender is a Solutions Architect at AWS, based in Pennsylvania. He works with customers in the Northeast U.S. to craft highly scalable, flexible, and resilient cloud architectures that address customer business problems. In his spare time, he tries his hand at new recipes from across the world in the kitchen.

Sanjukta Mukherjee

Sanjukta Mukherjee

Sanjukta Mukherjee is a Solutions Architect at AWS based out of New York. She works with customers from various industries helping them accelerate their adoption of AWS Cloud. She is responsible for helping customers to innovate and modernize their applications using AWS.


Integrate Salesforce knowledgebase with Amazon Connect Wisdom