> For the complete documentation index, see [llms.txt](https://chatlyst.gitbook.io/chatlyst-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatlyst.gitbook.io/chatlyst-user-guide/settings/conversation-tags.md).

# Conversation Tags

### Chatlyst Radar and Conversation Tags

[**Chatlyst Radar**](#chatlyst-radar-ai): Chatlyst Radar is an automated monitoring tool that scans customer chats to detect potential issues. The system reviews conversation records every 12 hours to identify risks and organize chats entirely in the background, requiring no manual effort from the user.

[**Conversation Tags**](#conversation-tags): Conversation Tags are custom labels used to organize and sort active customer chats. Applying these tags allows support teams to easily filter messages, track specific topics, and maintain a structured workspace. There are two distinct types of tags available: Normal and Complaint Tags.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F9DKlm6QVLaV5Yyfk2Dno%2Fimage.png?alt=media&amp;token=474a0050-cd2d-46be-9fc9-83d9e3f6d6c5" alt=""><figcaption></figcaption></figure></div>

***

### Chatlyst Radar (AI)

Chatlyst Radar is an AI tool designed to monitor customer conversations and automatically identify potential complaints or issues. By analyzing customer interaction logs every 12 hours, the system flags risks and organizes conversations without requiring manual input.

**Key Features and Benefits**

* **Automated Complaint Tagging:** Chatlyst Radar automatically monitors customer interactions to detect issues and applies a relevant complaint tag. To prevent redundant labels and maintain an organized workspace, the system first searches for and applies the most suitable existing tag; if no matching tag is found, it automatically generates and assigns a new one directly to the conversation.
* **Scalability:** As conversation volume increases, the system automatically adapts to identify various, unexpected complaints.
* **Time Savings:** Removes the need to manually read logs and sort customer complaints.
* **AI Complaint Radar Summary**: The AI Complaint Radar Summary is an automated advisory report generated by the system. It analyzes recent customer interactions to identify risks and suggest workflow improvements. Refer to the [Tags Summary: AI Complaint Radar Summary](/chatlyst-user-guide/dashboard/tags-summary.md#ai-complaint-radar-summary) guide for more details.

#### Enabling Chatlyst Radar

To activate this feature, locate the Chatlyst Radar setting and toggle the switch to the On position.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F2JraBzAeL0b3V23UDB85%2Fimage.png?alt=media&amp;token=bf93a058-8a12-461f-b4b2-2e7718cc2bf9" alt=""><figcaption><p>Chatlyst Radar Inactive</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F7j8Je01uqQpjuypFpBaC%2Fimage.png?alt=media&amp;token=4788b1b6-4b5b-4ce5-8e4d-01d9eef01c2f" alt=""><figcaption><p>Chatlyst Radar Active</p></figcaption></figure></div>

#### Unlocked Features

Activating Chatlyst Radar automatically unlocks several new monitoring and reporting tools across the platform:

* [AI Complaint Radar Summary](/chatlyst-user-guide/dashboard/tags-summary.md#ai-complaint-radar-summary): A detailed advisory report that becomes visible within the Tags Summary section.
* New Dashboard Metrics: Additional data points will appear on your main Dashboard to help track performance. These include: [Active Complaints](/chatlyst-user-guide/dashboard/dashboard.md#active-complaints), [Top Issues](/chatlyst-user-guide/dashboard/dashboard.md#top-issues), [CSAT](/chatlyst-user-guide/dashboard/dashboard.md#csat), [Tag Coverage](/chatlyst-user-guide/dashboard/dashboard.md#tag-coverage) and [Complaint Tracer](/chatlyst-user-guide/dashboard/dashboard.md#complaint-tracer).

#### Understanding Credit Consumption

Using Chatlyst Radar requires additional AI Response credits. Activating automated features increases the credit cost per message. Review the table below to understand how credits are calculated.

| Active Features                                                                                                                                                          | Total Credits Consumed (Per Message) | Cost Breakdown                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | ------------------------------------------------ |
| **Standard Bot Reply Only**                                                                                                                                              | 1 Credits                            | 1 (Standard Reply)                               |
| **Standard Bot Reply + Chatlyst Radar**                                                                                                                                  | 2 Credits                            | 1 (Standard Reply) + 1 (Radar)                   |
| **Standard Bot Reply + Chatlyst Radar +** [**Auto-Update Customer Attributes**](/chatlyst-user-guide/settings/customer-attributes.md#auto-update-customer-attributes-ai) | 3 Credits                            | 1 (Standard Reply) + 1 (Radar) + 1 (Auto-Update) |

{% hint style="info" %}
Auto-Update Customer Attributes is a separate AI feature that automatically modifies user profiles based on chat context. Having both this feature and Chatlyst Radar enabled simultaneously will result in a total cost of 3 credits per message.
{% endhint %}

***

### Conversation Tags

Conversation tags are custom labels used to categorize and sort active customer interactions. By applying tags, agents can easily filter conversations, track specific issues, and keep the workspace organized.

There are two types of label categories available:

* **Normal Tags:** Standard labels used for general categorization. Users can customize the color of these tags.
* **Complaint Tags:** Specific labels used to flag customer complaints or issues. To ensure high visibility, these tags are strictly assigned the color red and cannot be customized.

#### How to Create a New Tag

{% stepper %}
{% step %}
Select **Create New Tag**.

<figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FyJWijq3Aw6KohonOY7cv%2Fimage.png?alt=media&amp;token=644262bf-7ec3-4831-8593-2bcb09fd4e9a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter a clear and recognizable title in the **Tag Name** field.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FN0yOp9l42h7exdxihZ8f%2Fimage.png?alt=media&amp;token=169e5651-27cc-4e4a-b77f-209bf27505a7" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Enter a brief explanation in the **Description** field to detail when agents should use this tag.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FFHScToLc7TuzRJxAAT05%2Fimage.png?alt=media&amp;token=d751f8df-ad21-41c4-a2ef-400a8a39d121" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Choose the **Label Type** by selecting either **Normal** or **Complaint**, then selec the **Tag Color.**

{% hint style="info" %}
To ensure these urgent issues are highly visible to the team, the system automatically assigns the color red to all complaint tags.
{% endhint %}

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FdJ35d6joqjlLDW1x6YQw%2Fimage.png?alt=media&amp;token=6d0302d2-f9fb-4ba1-830e-ba68f48cd9d6" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FMXrATMcEqAgUTNN1VtY7%2Fimage.png?alt=media&amp;token=6685e0f1-31b2-4216-b1b0-e25febbe2194" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select **Create Tag** to save your new tag, or select **Cancel** to discard the changes.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FNMTKAWKJdTWVF1yZ1PTY%2Fimage.png?alt=media&amp;token=b5382fd9-bdfa-4b19-967a-4f933786811e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Viewing Existing Tags

Once a tag is created, it will appear in the system under the **Existing Tags** section. To help with organization, the system automatically divides your active labels into two distinct lists: **Complaint Tags** and **Normal Tags**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FRkPm4Ei1mOxvrX4k8YND%2Fimage.png?alt=media&amp;token=b9461670-dec4-478c-99c1-a952b770faf1" alt=""><figcaption></figcaption></figure></div>

#### How to Edit an Existing Tag

{% stepper %}
{% step %}
Locate the specific tag you wish to modify under the **Existing Tags** list. Select the **Pen** icon next to the tag to open the editing menu.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FeyBLg1RWuCdI5kom2zL0%2Fimage.png?alt=media&amp;token=518135fb-f31b-4263-8c4a-cc0e9da32840" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Update the Name, Description, Label Type or Color as needed. Select **Save** to apply or select **Cancel** to discard.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FPo1RLxiSE8mIlxw3UZQg%2Fimage.png?alt=media&amp;token=1f044a30-490e-4ec1-9e90-2ced8c1c3264" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### How to Delete a Tag

{% stepper %}
{% step %}
Locate the specific tag you wish to remove under the **Existing Tags** list. Select the **Bin** icon next to the tag. A confirmation window will appear.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FPnoIAZOdEWNK9dSUNjWC%2Fimage.png?alt=media&amp;token=3655e508-f21d-4959-895f-10e791289f31" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select **Delete** to confirm the removal, or select **Cancel** to keep the tag.

{% hint style="warning" %}
Deleting a tag is a permanent action that cannot be undone. Once deleted, the tag will be immediately removed from all historical and active conversations it was previously attached to.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FfHMsAIBDI7nwQ1HQhYqn%2Fimage.png?alt=media&amp;token=6450dfea-b961-4f97-bc23-2f80b0ba732d" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}