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

# Tags

> Tags are an essential tool for effectively organizing and categorizing phone calls on the Volubile platform. They allow descriptive labels to be associated with calls, making it easier to sort, track, and analyze them.

<Frame>
  <img src="https://mintcdn.com/weengage/mhYCLtO-hnadvSzt/images/settings/tags/volubile-tags-overview.png?fit=max&auto=format&n=mhYCLtO-hnadvSzt&q=85&s=2c10594d3ccd32d0c555c0594bb0241e" alt="Main tag management interface" width="2800" height="1800" data-path="images/settings/tags/volubile-tags-overview.png" />
</Frame>

## Tag Management Interface

This interface displays the following information:

| Column       | Description                            |
| ------------ | -------------------------------------- |
| Tags         | Name of the tag                        |
| Date Created | Date and time the tag was created      |
| Last Updated | Date and time of the last modification |
| Actions      | Buttons to edit or delete the tag      |

## Managing Tags

To add a new tag, click the purple button **Create a tag**, located at the top right of the interface. Once the name is entered in the designated field, creation can be confirmed by submitting.

<Frame>
  <img src="https://mintcdn.com/weengage/mhYCLtO-hnadvSzt/images/settings/tags/volubile-tags-create.png?fit=max&auto=format&n=mhYCLtO-hnadvSzt&q=85&s=91c18ba08cbf096115b5f059adb04396" alt="Creating a new tag" width="1223" height="438" data-path="images/settings/tags/volubile-tags-create.png" />
</Frame>

## Applying Segmentation Tags

### Automatic Assignment via API

Segmentation tags can be automatically applied during calls using the Volubile API. This feature allows contextual tags to be associated.

### Assignment via SIP Headers

It is also possible to send a list of tags directly through the SIP header `X-Volubile-System-Tags` during call setup. This method enables seamless integration with your existing systems.

```text Examples theme={null}
X-Volubile-System-Tags = To be processed
X-Volubile-System-Tags = city:Grenoble
X-Volubile-System-Tags = city:Grenoble,To be processed
```

## Using Tags on the Platform

Tags form a flexible system, adaptable to the specific needs of each business. They can be used as an integrated mini-CRM, allowing for tracking the status and evolution of customer interactions.

### Common Use Cases

<CardGroup cols={2}>
  <Card title="Status Tracking" icon="flag-checkered">
    "To be processed", "In progress", "Done", "Urgent"
  </Card>

  <Card title="Type of Request" icon="folder-open">
    "Technical support", "Sales", "Complaint"
  </Card>
</CardGroup>

### Tag Visibility

Tags are visible in several key areas of the platform:

<CardGroup cols={2}>
  <Card title="Call Detail" icon="phone">
    The tags associated with a call can be viewed directly from its detailed record.

    [See the Call Detail documentation](../calls)
  </Card>

  <Card title="Call Filtering" icon="filter">
    An agent's call history can be filtered based on tags.

    [See the call history documentation](../agents)
  </Card>
</CardGroup>

<Tip>
  A clear and consistent naming convention for custom tags contributes to better organization.
</Tip>

### Categorization System

Tags support a categorization system using the format `category:value`. This structure allows for hierarchical organization of tags:

<CardGroup cols={2}>
  <Card title="Category Examples" icon="folder-tree">
    * `campaign:christmas-promo`
    * `priority:high`
    * `segment:premium`
    * `source:website`
  </Card>

  <Card title="Smart Filtering" icon="filter">
    On the dashboard, categories appear as organized groups, making selection and analysis easier.
  </Card>
</CardGroup>