Stay organized with collectionsSave and categorize content based on your preferences.
Overview
Custom Highlights functions in a similar way as theSmart Highlightsfeature. Ahighlightcontains key words or phrases that
Insights recognizes as being important to determining the user's
intent. If highlights are present, they are labeled in the returned transcript.
Smart Highlights automatically detects highlights based on a range of pre-set
scenarios, while Custom Highlights lets you specify custom criteria that should
be recognized as highlights.
A custom highlight can be made up of one or morephrase match rule groups.
A phrase match rule group contains one or morerules. You can use the
following parameters to customize the behavior of your rules.
Rules to determine a match
You can specify whether a highlight should be detected if only one of the
rule groups resolves totrue, or if all of the rule groups resolve totrue.
Similarly, you can specify that a rule group should resolve totrueif only
one of its rules is met, or if conditions for all rules in the rule group must
be met.
Create a custom highlight using the console
Permissions required for this task
To perform this task, you must have the followingpermissions:
SelectConversation Highlightsfrom the navigation menu on the left
and go to theCustom Highlightstab.
ClickAdd New, then type in the highlight name and the key words to be
detected.
The configuration in the console assumes the following:
There are at most two phrase match rule groups in the highlight andALL_OFlogic is applied at highlight level.
One of the phrase match rule groups must contain positive conditions and
default toANY_OFlogic (represented byKeywords to match). You can
add a second phrase match rule group that only contains negative conditions
and defaults toALL_OFlogic (represented byKeywords to exclude).
Keywords are case insensitive.
Analyze a Insights conversation
After a custom highlight is created, you can use it to analyze your
conversations. See the how-to section to learnhow to analyze a conversation.
When an analysis has completed, you can view your custom highlights annotations
in theAnnotationspanel along with other types of annotations in each
conversation.
In theCustom Highlightstab, you can also find a chart and a table that
display the number of each highlight present in the analyzed conversations for
different time windows.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eCustom Highlights allow users to define specific criteria for identifying key words or phrases in conversations, similar to Smart Highlights but with user-defined rules.\u003c/p\u003e\n"],["\u003cp\u003eA custom highlight is built using phrase match rule groups, which consist of one or more rules, and users can specify if one or all rules need to be met for a match.\u003c/p\u003e\n"],["\u003cp\u003eCreating a custom highlight involves navigating to the Custom Highlights tab in the Insights console, and requires the \u003ccode\u003econtactcenterinsights.phraseMatchers.create\u003c/code\u003e permission.\u003c/p\u003e\n"],["\u003cp\u003eThe console's user interface for creating highlights has certain configuration limitations, such as supporting a maximum of two phrase match rule groups, and for full functionality, the REST API must be used.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating custom highlights, users can analyze conversations to view the highlight annotations in the Annotations panel, and a chart and table are available to display the frequency of each highlight over time.\u003c/p\u003e\n"]]],[],null,["# Analyze conversations using Custom Highlights\n\nOverview\n--------\n\nCustom Highlights functions in a similar way as the [Smart Highlights](/contact-center/insights/docs/smart-highlights)\nfeature. A **highlight** contains key words or phrases that\nInsights recognizes as being important to determining the user's\nintent. If highlights are present, they are labeled in the returned transcript.\nSmart Highlights automatically detects highlights based on a range of pre-set\nscenarios, while Custom Highlights lets you specify custom criteria that should\nbe recognized as highlights.\n\nA custom highlight can be made up of one or more **phrase match rule groups** .\nA phrase match rule group contains one or more **rules**. You can use the\nfollowing parameters to customize the behavior of your rules.\n\n### Rules to determine a match\n\nYou can specify whether a highlight should be detected if only one of the\nrule groups resolves to `true`, or if all of the rule groups resolve to `true`.\nSimilarly, you can specify that a rule group should resolve to `true` if only\none of its rules is met, or if conditions for all rules in the rule group must\nbe met.\n\nCreate a custom highlight using the console\n-------------------------------------------\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `contactcenterinsights.phraseMatchers.create`\n\n1. Navigate to the [Insights console](https://ccai.cloud.google.com/insights).\n2. If prompted, sign in using your Google Account.\n3. Enter your project ID.\n4. Select ***Conversation Highlights*** from the navigation menu on the left and go to the ***Custom Highlights*** tab.\n5. Click ***Add New***, then type in the highlight name and the key words to be detected.\n\n| **Note:** The user interface supports a subset of total possible configurations. To access all possible configurations, you must [use the REST API](/contact-center/insights/docs/custom-highlights-api).\n\nThe configuration in the console assumes the following:\n\n- There are at most two phrase match rule groups in the highlight and `ALL_OF` logic is applied at highlight level.\n- One of the phrase match rule groups must contain positive conditions and default to `ANY_OF` logic (represented by ***Keywords to match*** ). You can add a second phrase match rule group that only contains negative conditions and defaults to `ALL_OF` logic (represented by ***Keywords to exclude***).\n- Keywords are case insensitive.\n\nAnalyze a Insights conversation\n-------------------------------\n\nAfter a custom highlight is created, you can use it to analyze your\nconversations. See the how-to section to learn\n[how to analyze a conversation](/contact-center/insights/docs/create-analyze-conversation-ui).\n\nWhen an analysis has completed, you can view your custom highlights annotations\nin the ***Annotations*** panel along with other types of annotations in each\nconversation.\n\nIn the ***Custom Highlights*** tab, you can also find a chart and a table that\ndisplay the number of each highlight present in the analyzed conversations for\ndifferent time windows.\n| **Note:** A conversation can have multiple custom highlights of the same name. The Custom Highlights feature is applied at the conversation segment level rather than the entire conversation."]]