# Tags

To make items in the **Content** section conditional to a specific state we use [conditions](https://manuals.dialox.ai/studio/flows/conditions). Conditions can be based on the existence or non-existence of tags.&#x20;

Any flow node can be configured to set a tag when executed.&#x20;

Tags can also be set automatically by the system based on a context or system event.

### System tags&#x20;

This paragraph gives an overview of all the tags that are set by the system.

| Tag          | Explanation                                                                                                    |
| ------------ | -------------------------------------------------------------------------------------------------------------- |
| online       | The conversation happens within [office hours](https://manuals.dialox.ai/settings/app-settings/opening-hours)  |
| offline      | The conversation happens outside [office hours](https://manuals.dialox.ai/settings/app-settings/opening-hours) |
| web\_capable | The conversation happens on a weblike channel (PWA, widget or studio)                                          |

### User tags

The following tags are automatically set based on the basic user fields for **Name**, **Email**, **Phone** and **Language**.

<figure><img src="https://3356808761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEBQHGJABNTj5ISSOTRxM%2Fuploads%2Fw5ggbLYKbPlMWn905hYe%2Fimage.png?alt=media&#x26;token=9f4efe1f-b0fd-4920-9668-6590ba91799e" alt=""><figcaption><p>Tags used to indicate the presence of reserved user fields</p></figcaption></figure>

{% hint style="info" %}
When you introduce new user fields, make sure to add a tag for them here too.
{% endhint %}

The **Remember** option in **Ask Choice**, **Ask Open**, etc will store the value in the user object as well as set a user tag using the **Assign to** property.

| Tag         | Explanation                                     |
| ----------- | ----------------------------------------------- |
| user:phone  | The phone number of the contact is known.       |
| user:name   | The name of the contact is known                |
| user:email  | The email of the contact is known               |
| user:mobile | The phone number of the user is a mobile number |

### Call status tags

For bots used on a phone channel the latest call status of the conversation will be annotated in the conversation using the following tags to be able to identify what happened to phone calls in the underlying phone system (pbx):

<figure><img src="https://3356808761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEBQHGJABNTj5ISSOTRxM%2Fuploads%2FRNdpdRODjxZ6ihRvMzAD%2Fimage.png?alt=media&#x26;token=c35b067a-0da9-4dcd-81e2-017cde075a50" alt=""><figcaption><p>Call status tags</p></figcaption></figure>

### Language tags

The following tags will be set to annotate the language the conversation is in at any given time. It will be set at conversation start, but also when using the flow nodes [ask: language](https://manuals.dialox.ai/studio/flows/nodes/ask-language) and [switch language](https://manuals.dialox.ai/studio/flows/nodes/control-flow-switch-language).&#x20;

For every supported language there is a tag available on your bot:

<figure><img src="https://3356808761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEBQHGJABNTj5ISSOTRxM%2Fuploads%2Flg42pWF3SvDUXS14NZTM%2Fimage.png?alt=media&#x26;token=f9981121-9aac-45e2-9068-c6b1d1deaf21" alt=""><figcaption><p>Language tags</p></figcaption></figure>

{% hint style="info" %}
Note that, although a number of languages are supported in the platform, it will only allow the language to switch to the languages defined in your [Bot settings](https://manuals.dialox.ai/settings/app-settings/app-identity).
{% endhint %}

### Custom tags

To use tags in **Flows** or other parts of the system it is recommended to explicitly configure them under **Setting > Tags**. This way both the system as well as you and your colleagues can understand what tags are set. The system tags are also listed here.

<figure><img src="https://3356808761-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEBQHGJABNTj5ISSOTRxM%2Fuploads%2FO46tQ33aT1Mkk0IPEVdi%2FScreenshot%202024-05-16%20at%2014.15.55.png?alt=media&#x26;token=d6eec50f-7f7e-469b-b7e1-1195dea81913" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuals.dialox.ai/studio/flows/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
