{"id":21209,"date":"2019-05-27T07:07:40","date_gmt":"2019-05-27T06:07:40","guid":{"rendered":"https:\/\/developer.kore.ai\/?p=21209"},"modified":"2021-06-22T11:02:03","modified_gmt":"2021-06-22T10:02:03","slug":"sentiment-management","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/bots\/advanced-topics\/sentiment-management\/","title":{"rendered":"Sentiment Management"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row via_grid cols_1 laptops-cols_inherit tablets-cols_inherit mobiles-cols_1 valign_top type_default stacking_default\"><div class=\"wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><p><strong><span style=\"font-weight: 400;\">Emotion tones are critical indicators in understanding the attitudes and opinions of users interacting with the bots. <\/span>Sentiment Management<\/strong> allows the developer to define and trigger events based on the user\u2019s emotion or sentiment.<\/p>\n<p>Notes: This feature is not supported in all languages. <a href=\"\/docs\/bots\/how-tos\/multi-lingual-bot-behavior\/#Feature_Support\" target=\"_blank\" rel=\"noopener noreferrer\">Click here for details<\/a>.<\/p>\n<p><span style=\"font-weight: 400;\"> Negative emotion scenarios like anger or disgust are typically considered for transferring the conversation to a live agent<\/span>.<\/p>\n<p>The Natural Language Processing (NLP) interpreter can parse user utterances for specific words and phrases, and then provide an average tone score based on the connotation, word placement, and any added modifiers. (<a href=\"\/docs\/bots\/advanced-topics\/working-with-tone-processing\/\">Click here for more on Tone Analysis<\/a>)<\/p>\n<p>The tone or sentiment scores are stored as context and used to drive the flow of a dialog task through conditional transition statements. You can use these scores to steer user-bot conversations or seamlessly invoke escalation to a live agent.<\/p>\n<\/div><\/div><div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h2><span class=\"ez-toc-section\" id=\"Configuration\"><\/span>Configuration<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>You can define multiple sentiment events from <b>Intelligence -&gt; Sentiment &lt; Management<\/b>.<\/p>\n<p>Use <b>New Event<\/b> to define an event to capture the user&#8217;s emotion.<\/p>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/s3-us-east-2.amazonaws.com\/kore-wordpress\/developer.kore.ai\/wp-content\/uploads\/sites\/22\/20210622110140\/intelligence_Sentiment.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-27894\" src=\"https:\/\/s3-us-east-2.amazonaws.com\/kore-wordpress\/developer.kore.ai\/wp-content\/uploads\/sites\/22\/20210622110140\/intelligence_Sentiment.png\" alt=\"\" width=\"1363\" height=\"621\" \/><\/a><\/p>\n<\/div><\/div><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><p><span style=\"font-weight: 400;\">Following parameters can be configured for a sentiment event:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><b>Event Name<\/b><span style=\"font-weight: 400;\"> &#8211; Name of the event.<\/span><\/li>\n<li style=\"font-weight: 400;\"><b>Event Trigger<\/b><span style=\"font-weight: 400;\"> &#8211; Defines how often the sentiment must be checked. It can be set to: <\/span>\n<ul>\n<li style=\"font-weight: 400;\"><b>On Task Completion<\/b><span style=\"font-weight: 400;\"> &#8211; Sentiment is checked only after completion of a task (dialog, action, alert, and information task).<\/span><\/li>\n<li style=\"font-weight: 400;\"><b>After Every User Message<span style=\"font-weight: 400;\"> &#8211; Sentiment is checked after every message from the end-user. The event is evaluated before proceeding with the conversation using the incoming utterance.<\/span><\/b><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><strong>Emotion Configurations<\/strong>\n<ul>\n<li style=\"font-weight: 400;\">Select the required emotions to be captured from a list of six tones, <span style=\"font-weight: 400;\">angry, <\/span><span style=\"font-weight: 400;\">disgust, <\/span><span style=\"font-weight: 400;\">fear, <\/span><span style=\"font-weight: 400;\">sad, <\/span><span style=\"font-weight: 400;\">joy, and <\/span><span style=\"font-weight: 400;\">positive.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Select if the tone should be considered at the <em>Session<\/em> level or <em>Message<\/em> level<\/span>\n<ul>\n<li>Session-level tone value is a consolidated tone value across all user messages in a conversation session.<\/li>\n<li>Message-level tone value is a tone value calculated for a given message from the user.<\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Define the range to be considered for each of these tones, the range can be between -3 to +3<\/span><span style=\"font-weight: 400;\">. <\/span>(<a href=\"\/docs\/bots\/advanced-topics\/working-with-tone-processing\/\">Click here for more<\/a> on Tone Analysis)<\/li>\n<li style=\"list-style-type: none;\">When multiple emotions are selected, the event is triggered when ALL the tone rules are met. In case you want the event to trigger when any tone rule is met, add them as separate rules.<br \/>\nThe platform can identify the emojis in user utterances and set the tone accordingly.<\/li>\n<li style=\"font-weight: 400;\"><b>Event Configuration<\/b> &#8211; The result of the event trigger could be either to <b>Run a Dialog<\/b> or <b>Run a Script.<\/b><br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/s3-us-east-2.amazonaws.com\/kore-wordpress\/developer.kore.ai\/wp-content\/uploads\/sites\/22\/20210622105936\/intelligence_Sentiment_Event.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-27892\" src=\"https:\/\/s3-us-east-2.amazonaws.com\/kore-wordpress\/developer.kore.ai\/wp-content\/uploads\/sites\/22\/20210622105936\/intelligence_Sentiment_Event.png\" alt=\"\" width=\"699\" height=\"763\" \/><\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/div><\/div><div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h2><span class=\"ez-toc-section\" id=\"Event_Flow\"><\/span><span style=\"font-weight: 400;\">Event Flow<\/span><span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Emotion tones are continuously updated whenever a message received from the users and as such the sentiment events are also continuously evaluated. When an event\u2019s criteria are met, the platform triggers the defined behavior.<\/p>\n<ul>\n<li>If the configuration used is to <strong>Initiate a task<\/strong>, then the current task is discarded and the bot switches to the new task according to the event configuration.\n<ul>\n<li>Any other implicitly paused tasks will also be discarded.<\/li>\n<li>Tasks that are kept on hold using Hold and Resume settings are resumed as per Hold and Resume configuration.<\/li>\n<li>If the dialog selected to trigger for the sentiment event is not available for any reason, then a standard response is displayed. Refer to the standard response with the title <em>Dialog task required for conversation is not available<\/em>\u00a0for more information. (<a href=\"\/docs\/bots\/bot-intelligence\/default-dialog\/#Managing_Standard_Responses\" target=\"_blank\" rel=\"noopener noreferrer\">more on standard responses<\/a>).<\/li>\n<\/ul>\n<\/li>\n<li>If the configuration used is to <strong>Run the script<\/strong>, then the platform executes the script and continues with the task execution. In case of any errors executing the script associated with the sentiment event, then a standard response is displayed. You may refer to the standard response titled <em>Error in continuing the conversation due to incorrect bot definition<\/em>\u00a0for more information. (<a href=\"\/docs\/bots\/bot-intelligence\/default-dialog\/#Managing_Standard_Responses\" target=\"_blank\" rel=\"noopener noreferrer\">more on standard responses<\/a>).<\/li>\n<li>In case of a conflict between a sentiment event and direct intent invocation by the user, sentiment event is given precedence.<\/li>\n<li>When tone criteria for two or more sentiment events are satisfied at the same instance, then the platform prefers the sentiment event with the highest order of precedence used in defining the events.<\/li>\n<\/ul>\n<h5>Execution Flow for Universal Bots<\/h5>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Events configured at the universal bot are honored over the events defined in the child bots.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">If an event at the universal bot is qualified, then the corresponding behavior is triggered.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">If an event at the universal bot is not qualified or not defined, then the events defined for the child bot that the user is interacting with are evaluated and triggered if qualified. <\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">If no child bot is being executed, then child bot events are not evaluated.<\/span><\/li>\n<\/ul>\n<\/div><\/div><div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h2><span class=\"ez-toc-section\" id=\"Reset_Tone\"><\/span>Reset Tone<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><span style=\"font-weight: 400;\">By default, sentiment values are reset at the beginning of every user conversation session.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Apart from the beginning of the conversation session, the platform resets the sentiment values (i.e. tone scores) once the associated events are triggered. The reset behavior is based on the type of event trigger:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">If a script is run, then the values are reset after successful execution of the script.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In case of a dialog task is triggered, the values are transferred to the new dialog task&#8217;s (triggered by the sentiment event) context and reset in the original global context.<\/span><\/li>\n<\/ul>\n<\/div><\/div><div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>[vc_raw_html]JTNDZGl2JTIwY2xhc3MlM0QlMjJ3LXBvc3QtZWxtJTIwcG9zdF9uYXZpZ2F0aW9uJTIwbGF5b3V0X3NpbXBsZSUyMGludl9mYWxzZSUyMiUzRSUwQSUwOSUzQ2ElMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtJTIwb3JkZXJfZmlyc3QlMjB0b19wcmV2JTIyJTIwaHJlZiUzRCUyMmh0dHBzJTNBJTJGJTJGZGV2ZWxvcGVyLmtvcmUuYWklMkZkb2NzJTJGYm90cyUyRmJvdC1pbnRlbGxpZ2VuY2UlMkZpbnRlcnJ1cHRpb24taGFuZGxpbmctY29udGV4dC1zd2l0Y2hpbmctaW50ZW50cyUyRiUyMiUzRSUzQyUyRnAlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLWFycm93JTIyJTNFJTNDJTJGZGl2JTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS1tZXRhJTIyJTNFUHJldmlvdXMlM0MlMkZkaXYlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLXRpdGxlJTIyJTNFJTNDc3BhbiUzRURpYWxvZyUyME1hbmFnZW1lbnQlM0MlMkZzcGFuJTNFJTNDJTJGZGl2JTNFJTBBJTNDcCUzRSUzQyUyRmElM0UlM0NiciUyMCUyRiUzRSUwQSUzQ2ElMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtJTIwb3JkZXJfc2Vjb25kJTIwdG9fbmV4dCUyMiUyMGhyZWYlM0QlMjJodHRwcyUzQSUyRiUyRmRldmVsb3Blci5rb3JlLmFpJTJGZG9jcyUyRmJvdHMlMkZib3QtaW50ZWxsaWdlbmNlJTJGZGVmYXVsdC1kaWFsb2clMkYlMjIlM0UlM0MlMkZwJTNFJTBBJTNDZGl2JTIwY2xhc3MlM0QlMjJwb3N0X25hdmlnYXRpb24taXRlbS1hcnJvdyUyMiUzRSUzQyUyRmRpdiUzRSUwQSUzQ2RpdiUyMGNsYXNzJTNEJTIycG9zdF9uYXZpZ2F0aW9uLWl0ZW0tbWV0YSUyMiUzRU5leHQlM0MlMkZkaXYlM0UlMEElM0NkaXYlMjBjbGFzcyUzRCUyMnBvc3RfbmF2aWdhdGlvbi1pdGVtLXRpdGxlJTIyJTNFJTNDc3BhbiUzRURlZmF1bHQlMjBDb252ZXJzYXRpb25zJTNDJTJGc3BhbiUzRSUzQyUyRmRpdiUzRSUwQSUzQ3AlM0UlM0MlMkZhJTNFJTNDJTJGZGl2JTNF[\/vc_raw_html]<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"Emotion tones are critical indicators in understanding the attitudes and opinions of users interacting with the bots. Sentiment Management allows the developer to define and trigger events based on the user\u2019s emotion or sentiment. Notes: This feature is not supported in all languages. Click here for details. Negative emotion scenarios like anger or disgust are...","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[15],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/21209"}],"collection":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/comments?post=21209"}],"version-history":[{"count":26,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/21209\/revisions"}],"predecessor-version":[{"id":28811,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/21209\/revisions\/28811"}],"wp:attachment":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/media?parent=21209"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/categories?post=21209"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/tags?post=21209"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}