Configuring a Coveo Lightning Insight Panel for Cases

Pro and Enterprise editions only

Coveo for Salesforce 3 (May 2018)


Make sure that:

Completing Specific Lightning Insight Panel Configuration

The Lightning Insight Panel component offers a few functionalities that are specific to the Case object type. You should perform these additional steps to get the best of the component.

Since the case you are currently working on does not need to appear in your results, you can filter it out by following these steps:

  1. On the Case page, click Setup and then select Edit Page.

  2. After clicking anywhere on the Insight Panel, in the Record Fields, add the Case_CaseNumber field.

  3. In your Coveo Cloud administration console, in the Filters tab, click Add Rule.

    1. In the Add a Filter Rule page, under Query parameter, select cq (constant query)

    2. Under Query Filter, add the following code:

      NOT @sfcasenumber=$context.Case_CaseNumber
    3. Click Add Rule.

Adding the Coveo Attached Results Component

When used in the Case record page, the Lightning Insight Panel allows to attach search results to the case. The Coveo Attached Results component lists all the results attached to the current case.

To add the component, follow these steps:

  1. In Salesforce, access your Lightning Service Console, and then open any of your cases.

  2. At the top right of the page, click the cog icon (), and then select Edit Page.

  3. In the Lightning App Builder, Drag and drop the Coveo Attached Results component where you want it.

    Place the Lightning Insight Panel and the Coveo Attached Results components where we can see both of them at the same time.

  4. At the top right, click Save.

  5. Now that your page is saved, at the top right of the page, select Back.

Adding a Lightning Insight Panel to a Live Agent Chat Page

Step 1 - Adding an Insight Panel Component to a Live Agent Chat Page in Salesforce

  1. Ensure that you have enabled a Live Agent chat page in your Salesforce organization.

  2. In Salesforce, access your Lightning Service Console, and then open any of your Chat sessions.

  3. At the top right of the page, click the cog icon (), and then select Edit Page.

  4. In the Lightning App Builder, on the Live Chat Transcript Record Page, drag and drop the Coveo Insight Panel component to the right side panel.

  5. At the top right, click Save.

  6. If not already done, activate the new page.

    1. Click Assign as Org Default.

      You can make these changes available as default, or edit the assignment rules to only activate this page for specific users or profiles.

    2. Once you are done with the assignment rules, click the Save button.

  7. Now that your page is saved, in the top right of the page, select Back.

  8. In the Insight Panel, select the Set Up a Search Page button.

  9. Choose the tabs that you want to have in your panel, and then select Create Page. You can always change the tabs later.

You should now have a functional Coveo Lightning Insight Panel.

Step 2 - Configuring Your Live Agent Insight Panel Component in Coveo Cloud

  1. In your Coveo Cloud Administration Console (see Logging in to Coveo Cloud V2), select the query pipeline used by your Insight Panel, and then access the query pipeline Query Parameters tab (see Adding and Managing Query Pipeline Query Parameters).

    By default, your Insight Panel uses the Default pipeline .

  2. In the Machine Learning tab, add an Automatic Relevance Tuning (ART) model with the Enable Intelligent Term Detection (ITD) option selected (see Activating Machine Learning Intelligent Term Detection (ITD) in Salesforce).

  3. In the Query Parameters tab, add a rule overriding the large query (lq) parameter value:

    1. Click Add Rule, and then select Query Parameters With Code.

      1. In the Add a Rule With Code dialog, in the form editor box, enter the following rule:

        override query lq:"<@+ $context.LiveAgent_AllVisitorMessages +@>"

        The context can either be: LiveAgent_LastVisitorMessage, LiveAgent_LastAgentMessage, LiveAgent_AllVisitorMessages, or LiveAgent_AllAgentMessages.

        The LiveAgent_AllVisitorMessages context value provides all the customers messages and context from which Coveo Machine Learning can identify relevant keywords. With LiveAgent_LastVisitorMessage, the previous messages context values are excluded. LiveAgent_LastAgentMessage and LiveAgent_AllAgentMessages context values only show agent results.

      2. Click Add Rule.

    2. In the Action bar, click More, and then select Select condition.

    3. Add a Condition that is applied when an empty query is performed (see Create a Condition).

      You can use the same query pipeline for both of your Case and Live Agent chat pages, but you have to enter different SearchHub names, typically AgentCase and AgentChat.

      Ensure that, when adding the overriding rules in your Query Parameters for each Insight Panel, you create a condition Search hub is [SearchHub name] for each Search hub.

  4. Your Query Parameters tab should now look like this:

What’s Next?

Depending on your use case, you must add the custom dimensions to make the search and click events metadata available in your usage analytics reports (see Adding and Managing Dimensions on Custom Metadata).

  • For the Live Agent Chat Page: add context_liveagent_allvisitormessages, context_liveagent_allagentmessages, context_liveagent_lastvisitormessage, or context_liveagent_lastagentmessage dimensions.
Recommended Articles