communications-mining
latest
false
Important :
Communications Mining is now part of UiPath IXP. Check the User Guide Introduction for more details.
UiPath logo, featuring letters U and I in white

Communications Mining User Guide

Last updated Mar 25, 2025

Monitoring

Tone analysis

User permissions required: ‘Modify datasets’ to enable Tone analysis.

What is tone?

Tone analysis is the process of understanding and identifying the emotional tone or attitude expressed in a message.

The primary purpose of tone analysis is to gain insights into the emotional state of the writer to understand how they're feeling about a specific subject or topic.

Leveraging the platform's tone analysis capabilities allows users to be proactive in customer experience management, and can help users anticipate and address customer needs based on the emotions expressed within their communications.

When should we use tone vs. label sentiment?

Label sentiment is typically only appropriate for customer feedback related datasets. This is because they contain many more identifiable expressions of sentiment than other datasets, which tend to be much more neutral by nature.

For all other use cases (e.g. email inbox analysis and automation), tone should be used because the emotional tone expressed in a message may not simply be a positive vs. a negative sentiment. It could be a complex spectrum of emotions, better represented by a scoring system. The majority of communications in these datasets are also neutral in tone, which is not captured by label sentiment analysis.

How does it work?

Communications Mining's tone model is trained to look for specific expressions of sentiment, both positive and negative, and aggregates them up into an overall 'tone score' between -10 and 10.

This score then becomes a filterable / queryable property for each message, and can be aggregated up at different levels in Reports.

Additionally, the tone score is used as a contributing factor in generating Quality of Service (QoS) scores.

How to set this up

Step 1: Ensure that you have the right permissions to enable QoS ('Quality of Service')

Step 2: Turn tone in the dataset. This can be enabled in the dataset's settings page at any time.

Tone Analysis Toggle

What does it look like?

Example message with Tone enabled

Quality of Service

User permissions required: ‘Quality of Service’ AND ‘Pre-trained labels’.

What is Quality of Service (QoS)?

The platform combines the overall sentiment, i.e. tone, and impact of intents in every message to automatically compute a configurable Quality of Service (QoS) score for each message. It also enables real-time QoS dashboards and alerting based on predefined thresholds.

This functionality has many useful applications, including (but not limited to):

  • Quality assurance across customer facing teams.
  • Identification of prevalent customer issues & recovery opportunities.
  • Performance monitoring & proactive customer interventions.
  • Prioritisation of agents’ work & time management.

The QoS feature helps to ensure that customers are provided with the highest quality of service, whilst identifying priority areas for improvement. It allows managers to measure agents’ performance, prioritise their work and drive timely interventions.

How does it work?

The platform automatically calculates a Quality of Service (QoS) score between -10 and 10 for every message. It does this by combining the predicted tone score (also -10 to 10) with the combined impact scores across label predictions (weighted by prediction confidence).

Label impacts make up the majority of the QoS score, with tone representing ~10% of the score.

How to set this up

Step 1: Ensure that you have the right permissions to enable QoS ('Quality of Service' AND 'Pre-trained labels' where applicable)

Step 2: Turn on pre-trained labels, on key QoS intents that are applicable to your use case. These can be made trainable or non-trainable.

QoS Labels

Step 3: Turn on tone analysis (tone is incorporated into the QoS score). This can be enabled in a dataset’s settings page (accessible via the top navigation bar), on the 'General' tab.

'Tone analysis' toggle on the dataset settings page

Step 4: Change the label impacts. Every label can be assigned an impact score from -10 to +10 (many are typically left at 0).

You can change the QoS label impact by clicking into a label's settings (via the Explore tab, on the taxonomy bar on the left-hand side), and adjusting the QoS slider on a label.

Slider to adjust QoS impact

Tracking and monitoring

Example QoS features associated with tracking and monitoring

We can use QoS within the following Communications Mining product features:

  • Charts: Charts displaying QoS are available in the Label Summary, Trends, and Segments tabs within Reports, and they can all be added to dashboards for monitoring.
  • Filters: QoS and tone scores become a property of each message, meaning they can be filtered on in Reports and Explore.
  • Explore: There are sort orders in Explore for QoS and Tone, allowing users to explore qualitative examples of high and low scoring messages.
  • Alerts: QoS and tone can be filter inputs to alerts, and alert types are available for tracking changes in QoS scores.

What does it look like?

Example message with QoS enabled

Alert Center

Note: Although issues are part of the IXP Administration page, they are specific to Communications Mining projects.
Note:
  • You must have the View Alerts and Alerts Admin permissions assigned to view and manage alerts and issues.
  • All users have the View Alerts permission by default, and are able to view all alerts and issues.
  • All users who created at least one project have the Alerts Admin permission enabled by default.

Alerts overview

The platform provides real-time alerting capabilities, so you can define issues that impact your clients, processes, and service quality. Moreover, the platform alerts you each time issues such as risk events, client complaints, long-running issues, breaks, and so on occur. Such notifications are currently available only on the platform.

The alerts functionality has many useful applications, including:

  • Communications volume and quality of service monitoring.
  • Prioritisation and resolution of issues as soon as they occur.
  • Triggering downstream automation.
  • Keeping an audit trail of resolved issues and tracking of unresolved issues.

The Alerts feature provides visibility into the recurring or high-risk issues in your communication channels. In addition, Alerts allows you to monitor unresolved issues. Once the issue is fixed, you can mark it as resolved.

Alert Center overview

To view issues or alerts, select the Alert Center tab in the Administration page. Then select the Issues or Alerts tabs. Once you set up your alerts, these trigger issues when their criteria is met, and are tracked in the Issues tab.

Active issues track how many times an alert was triggered while the issue remained unresolved. After you investigate and address an issue, you can then mark it as resolved. If the alert triggers again in the future, the platform creates a new issue.

Setting up an alert

The following alert types are currently available:
  • Alerts linked to email volumes. These focus on communications volume monitoring, for example, the number of exceptions or errors, or any instance of a specific high-risk event.
  • Alerts linked to average quality of service (QoS) scores. These focus on service quality monitoring, for example, changes in the QoS score for our high-risk or high-value customers.

To create and configure a new alert, proceed as follows:

  1. Go to the Alert Center in the Administration page.
  2. Select the Alerts tab, and then select the New alert button.
    Alert details + matched messages example

  3. On the configuration page, specify the following details for each alert:
    • The relevant project.
    • The relevant dataset.
    • The alert name.
    • The applicable filters.
      Note: The applicable filters are the same filters available in the Explore or Reports tabs, for example, label filters or user property filters. If no filters are applied, the alert is triggered on the entire dataset.
    Alert configuration window

  4. Link your alert to one or more datasets.
    Note: Alerts are linked to a primary dataset, to determine the available label filters, and then to any number of additional datasets that you have access to within the tenant.
  5. Select the alert type, Average Quality of Service or Volume, to customize individual conditions of the alert based on your business needs and objectives.


  6. Indicate the level of increase or decrease, and then specify the exact value or percentage.


  7. Select the time period you prefer.


  8. Define your ideal benchmark comparison:


  9. Select the filters. You can apply the standard filters to determine which messages should be considered for each alert.
  10. Select Preview alert to view how many times the alert would have been triggered in a past time period, for example, in six months.
    Note: The Preview alert functionality is particularly helpful when you define the specific conditions of the alert to ensure the platform does not create an overly sensitive alert, or one that is never triggered
  11. Select Create alert.
The alert configuration page

Example of a Quality of Service (QoS) alert

The objective of this example is to create an alert that gets triggered each time the average QoS score drops by 0.3 within a single day, compared to the long running average.

  1. When you configure your alert, select the Average Quality of Service alert type from the drop-down list, in the Datasets section.
  2. Select has a decrease of more than from the drop-down list.
  3. Enter 0.3 in the free-text field.
  4. Select 1 day.
  5. Select long running average.
  6. Select Preview alert.
  7. Select Create alerts.
Alert's conditions example

This particular alert would have triggered one issue in this period, and the issue would still be ongoing.

Preview Issues window

Editing and deleting alerts

To edit or delete an alert:
  1. Go to the Alert Center in the Administration page.
  2. Select the Alerts tab.
  3. Select the pencil icon on an alert to edit it, or select the bin icon on an alert to delete it.
Edit Alert window

Edit Alert window

Tracking and monitoring

You can use the quality of service (QoS) within the following Communications Mining product features:

  • Issues tab: This page tracks all active unresolved issues as well as past resolved issues, and provides an audit log of past issues.
  • Resolving issues: Active issues count the number of times the issue has been triggered until that point. Once you address the issue, an alert administrator can mark it as resolved.
  • Explore examples: When an alert triggers an issue, the issue card allows you to select examples of messages that cause the alert to trigger the issue, which allow investigation and resolution.
  • In-platform: Currently, issues are only tracked in-platform, but will be available through API in future releases.

Tracking and resolving alert-triggered issues

You can view in the Issues tab all identified issues that the alerts triggered. However, you can filter by the active or resolved issues:
  • Active issues: This filter allows you to track all unresolved issues.
  • Resolved issues: This filter allows you to keep an audit trail of all past issues

Once you investigate and fix an active issue, you can marked it as Resolved. You can reopen it, if needed.

Additionally, each issue contains relevant alert details, as well as all messages that match the alert. You can access the issue details if you select the respective arrow icons on the issue card.

Issue example

Alert details + matched messages example

Subscribing to alerts

To subscribe to alert notifications, proceed as follows:
  1. Select the Alert Center tab on the Administration page.
  2. Select the Alerts tab.
  3. Select the Subscribe button on a specific alert.

To unsubscribe from alerts, select the Subscribed button on an alert and select Unsubscribed from the drop-down list.

Filter the alerts you subscribed to through the Subscribed filter from Alert Center.

Note:
  • You can still select users when you edit the alert.
  • You can still unsubscribe from an alert if you do not have the permission to view that alert.
  • You do not need the Alerts Read permission to be subscribed to an alert by an alert administrator.
Note: Although issues are part of the IXP Administration page, they are specific to Communications Mining projects.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
© 2005-2025 UiPath. All rights reserved.