> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Adherence Heatmap

The **Adherence Heatmap** helps supervisors monitor how consistently agents meet evaluation metrics over time.

It provides a visual view of adherence trends across **evaluation forms, metrics, queues, agents, languages, date ranges, and interaction direction**.

Use it to identify recurring quality gaps, compare performance across inbound and outbound interactions, monitor compliance trends, and support targeted coaching decisions.

By default, the heatmap includes only evaluated interactions that are eligible for aggregation in all adherence calculations.

Interactions marked **Below Threshold** or **Duration Unavailable** are excluded unless they are **manually evaluated**.

A contact may fall below the threshold for one scorecard and remain eligible for another based on scorecard-specific duration rules.

## Why Use Adherence Heatmap?

| Use Case                 | How It Helps                                                        |
| ------------------------ | ------------------------------------------------------------------- |
| **Trend Monitoring**     | Tracks adherence trends across time and evaluation metrics.         |
| **Compliance Analysis**  | Identifies recurring failed and fatal quality metrics.              |
| **Directional Insights** | Separately analyzes inbound, outbound, or combined interactions.    |
| **Agent Coaching**       | Highlights low-performing agents and metrics.                       |
| **Interaction Review**   | Preserves drill-down to failed interactions in Conversation Mining. |

## Key Capabilities

* Tracks adherence using only interactions that meet evaluation criteria.
* Helps you filter interactions by Inbound, Outbound, or All directions.
* Automatically excludes interactions that are too short or don’t have duration data.
* Excludes flagged interactions (missing or unavailable duration data) by default.
* Supports you to include flagged interactions after reviewing them manually.
* Enables you to view these interactions in Conversation Mining.
* Helps you filter interactions by duration status.
* Applies appropriate duration rules based on the selected scorecard.

## Access Adherence Heatmap

Navigate to **Quality AI** > **Analyze** > **Adherence Heatmap**.

<img src="https://mintcdn.com/koreai/rZEx5QcYOsndKbuI/ai-for-service/quality-ai/analyze/adherence-heatmap/images/adherence-heatmap-landing-page.png?fit=max&auto=format&n=rZEx5QcYOsndKbuI&q=85&s=04a92342ee1815ca7e31a3f5d0563031" alt="Adherence Heatmap Landing Page" width="1905" height="667" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/adherence-heatmap-landing-page.png" />

Select an **evaluation form** from the dropdown to visualize adherence metrics.

<Note>Enables you to access **Auto QA** in **Settings** > **Quality AI General Settings**.</Note>

### Adherence Percentage Calculation

The system calculates adherence using only evaluated interactions that are eligible for aggregation, based on the selected evaluation form, agent, and date range.

### Formula

Adherence % = Adhered evaluated interactions ÷ Applicable evaluated interactions

***

## Handling Flagged Interactions

* By default, Below Threshold and Duration Unavailable interactions are excluded from adherence metrics and dashboard aggregates unless manually evaluated.
* A contact can fall Below the Threshold for one scorecard but meet evaluation criteria for another.
* Duration checks don't block ingestion, transcript storage, or Conversation Mining.
* Includes flagged contacts in heatmap metrics and treats them as standard post manual evaluation.
* Flagged interactions (All, Evaluated Only, Below Threshold, Duration Unavailable) remain available in Conversation Mining through the Duration Status filter.
* Flagged interactions remain available in Conversation Mining via the Duration Status filter (All, Evaluated Only, Below Threshold, Duration Unavailable), with drill-down and exclusion reasons shown in interaction details.

## Interaction Eligibility Rules

| Interaction Type                           | Included in Heatmap |
| ------------------------------------------ | ------------------- |
| **Evaluated**                              | Yes                 |
| **Below Threshold**                        | No                  |
| **Duration Unavailable**                   | No                  |
| **Manually Evaluated Flagged Interaction** | Yes                 |

### Metric Applicability

| Metric Type               | When It Applies                                                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Static** (by question)  | Apply to all evaluated interactions that are eligible for aggregation within the selected evaluation form and queue. |
| **Dynamic** (by question) | Apply only when the defined trigger condition is detected.                                                           |

### Color Coding

Each heatmap tile is color-coded by adherence percentage:

| Color    | Meaning                                             |
| -------- | --------------------------------------------------- |
| Red      | 0% adherence                                        |
| Green    | 100% adherence                                      |
| Gradient | Transitions in 10% increments between red and green |
| Gray     | No applicable evaluated interactions                |

### Failed and Fatal Interactions

| Category               | Description                                                                                                                                                                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Failed**             | Interactions that don't meet quality or compliance thresholds (for example, missed greetings, incorrect information, or compliance breaches).                                                                                                           |
| **Fatal Errors**       | Critical issues that automatically set adherence to 0% when a fatal error occurs (red).                                                                                                                                                                 |
| **Usage for Coaching** | Supervisors and agents use fatal error flags, heatmaps, and question-level feedback for self-assessment and coaching preparation. See [AI-Assisted Manual Audit](/ai-for-service/quality-ai/analyze/ai-assisted-manual-audit) for additional workflows. |

### Hover Tooltip

Hover over a tile to view the adherence percentage, the number of evaluated interactions, and failed interaction count.

The tooltip excludes Below Threshold and Duration Unavailable (flagged) interactions unless they are manually evaluated.

<img src="https://mintcdn.com/koreai/iznC8GHkhOKnM4fV/ai-for-service/quality-ai/analyze/adherence-heatmap/images/no-interaction.png?fit=max&auto=format&n=iznC8GHkhOKnM4fV&q=85&s=1d6bdee3f89dc8b8f84f280c76eca5fe" alt="No Interaction Tooltip" width="1366" height="630" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/no-interaction.png" />

***

## Filters

This helps supervisors to drill down into agent performance based on selected criteria.

### Date Range

The default date range is the last 7 days. The system uses the user's system time zone.

| View             | When it applies                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| **Daily**        | Date range of 1–14 days; each tile shows one day. Horizontal scroll appears for ranges over 7 days. |
| **Weekly**       | Date range over 14 days; each tile shows one full week.                                             |
| **Custom Range** | All interaction data from 12:00:00 AM to 11:59:59 PM in the agent's time zone, up to 31 days.       |

<img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/manual-evaluation-indicator.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=2e5736b532e2888bbf86c34524f0a617" alt="Manual Evaluation Metrics Indicator" width="809" height="278" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/manual-evaluation-indicator.png" />

### Manual Evaluation Metrics Indicator

Displays Manual Evaluation metrics with a visual identifier and represents unaudited conversations when no data is available in the Adherence Heatmap.

### Evaluation Form

Select an evaluation form from the dropdown to view adherence metrics. The selected form determines applicable metrics, queues, languages, and agents. You can set a default form across assigned queues; this selection persists across sessions on the Heatmap page and QA dashboard. Updating the default replaces the previous selection and refreshes the heatmap context, including highlighting fatal metrics.

### All Directions

Analyze adherence by interaction direction—Inbound (customer-initiated), Outbound (agent-initiated), or All Directions (combined). All Directions are the default selection and aggregate adherence totals and percentages across all eligible interactions.

### Agent

Supports multi-select. By default, all agents in the selected queues are shown. You can search and select agents to view adherence for their interactions; only relevant tiles remain active, while others appear disabled.

### Language

Supports multi-select from the dropdown based on languages configured in the evaluation form. When applied, only metrics for the selected languages are displayed.

<Note>Language options depend on the selected evaluation form.</Note>

***

## Clickable Functionality

### Adherence Heatmap Overview

The heatmap interface tracks agent adherence across selected metrics over a chosen date range, based on filters such as agents, evaluation form, and interaction status. Each tile represents a metric and displays interaction data for the selected period.

### Adherence Display

Sort the adherence column by percentage; by default, results are shown from lowest to highest adherence.

<img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/click-through.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=3add52bb14474c253aa85ba081d0e6fb" alt="Click-Through View" width="1089" height="354" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/click-through.png" />

### Heatmap Interaction

Select a date range tile to view an agent-wise breakdown for the selected metric, ordered from least to most adherence, with adherence percentages displayed.

<img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/adherence-percentage-count.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=3b41d3e1bb07d4b9e385bdf20e510ec5" alt="Adherence Percentage Count" width="1300" height="373" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/adherence-percentage-count.png" />

### View Interactions

Opens the page with failed interactions for all agents. The applied filters (shown as **Unsaved**) include the evaluation metric name and metric qualification (pass or fail count).

<img src="https://mintcdn.com/koreai/iznC8GHkhOKnM4fV/ai-for-service/quality-ai/analyze/adherence-heatmap/images/conversation-mining-failed-interactions.png?fit=max&auto=format&n=iznC8GHkhOKnM4fV&q=85&s=2fa193ef2d73f25f81cd4f5171767532" alt="Conversation Mining Failed Interactions" width="1912" height="643" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/conversation-mining-failed-interactions.png" />

### Behavior and Filters

**Interaction Display Rules**:

* Agents with no applicable interactions appear at the bottom of the list.

  <img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/not-applicable.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=bbe39e52b8e73c068115431439fa1500" alt="Not Applicable" width="646" height="135" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/not-applicable.png" />

* Agents with no applicable interactions appear at the end of the list.

* Tiles show No Interactions (gray) when interactions don’t apply.

* The system lists agents with failed interactions.

* The View Interactions action is disabled for agents with no applicable interactions or 100% adherence.

  <img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/no-interactions-with-failed-interactions.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=23a7a4db30477235a7ca8ed3c2f64cc5" alt="No Interactions with Failed Interactions" width="1363" height="434" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/no-interactions-with-failed-interactions.png" />

### Action Filters

| Action                       | Description                                                                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Filter Heatmap by Agent**  | Selecting the icon navigates to the agent's heatmap metrics page for the selected date range.                                 |
| **View Failed Interactions** | Selecting the agent interaction icon opens the Interactions page in Conversation Mining for that agent's failed interactions. |

<img src="https://mintcdn.com/koreai/9RBL0o61PLx920Nx/ai-for-service/quality-ai/analyze/adherence-heatmap/images/heatmap-by-agent.png?fit=max&auto=format&n=9RBL0o61PLx920Nx&q=85&s=3e6e5d5e375185d69d78503715975261" alt="Heatmap by Agent" width="497" height="311" data-path="ai-for-service/quality-ai/analyze/adherence-heatmap/images/heatmap-by-agent.png" />

***

### Dashboard View

Displays a simplified, non-interactive Adherence Heatmap for the last 7 days using the default evaluation form. It includes only evaluated interactions that are eligible for aggregation. Interactions marked Below Threshold or Duration Unavailable are excluded by default unless manually evaluated. Excluded interactions remain available in [Conversation Mining](/ai-for-service/quality-ai/analyze/conversation-mining-interactions) and [Reports](/ai-for-service/analytics/quality-ai/reports/scheduled-reports).

For details, see [Supervisor Dashboard](/ai-for-service/quality-ai/analyze/dashboard).

### View Interactions and Data Handling

Select View Interaction to open Conversation Mining with metric-based filters and notification tags. The system excludes Below Threshold and Duration Unavailable interactions from heatmap calculations by default unless they are manually evaluated. Notification tags appear only when navigating from the Adherence Heatmap.

***