> For the complete documentation index, see [llms.txt](https://docs.higiocloud.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.higiocloud.vn/management/1.-iam-portal/hi-gios-monitoring-alert-telegram-notification-channel.md).

# HI GIO's Monitoring Alert - Telegram notification channel

## <mark style="color:green;">**Overview**</mark> <a href="#introduction" id="introduction"></a>

This function allows users to create rules for receiving notifications via Telegram channels when the statuses of VMs exceed or fall below specific thresholds.

## <mark style="color:green;">**Procedure**</mark> <a href="#procedure" id="procedure"></a>

{% tabs %}
{% tab title="I. How to get BOT API TOKEN and Chat ID of Telegrambot" %}

#### &#x20;Please view this link to learn how to obtain the [BOT API TOKEN](https://gist.github.com/nafiesl/4ad622f344cd1dc3bb1ecbe468ff9f8a#create-a-telegram-bot-and-get-a-bot-token) and [Chat ID](https://stackoverflow.com/questions/32423837/telegram-bot-how-to-get-a-group-chat-id) <a href="#i.-how-to-get-bot-api-token-and-chat-id-of-telegram" id="i.-how-to-get-bot-api-token-and-chat-id-of-telegram"></a>

{% endtab %}

{% tab title="II. Creating Alert Contact Destination using the Telegram notification channel" %}
**Step 1:** Login HI GIO cloud > **Monitor**

**Step 2:** Select **Manage**, and Select **NEW** below *Alert Contact Destination* section

<figure><img src="/files/weX4vtfbNOXWMk7wsikv" alt=""><figcaption></figcaption></figure>

* New Alert Contact Destination will open

* Select Integration in Telegram

  <figure><img src="/files/yVwWdvlGsWwHb1Qx0CAa" alt=""><figcaption></figcaption></figure>

* Fill up contact information to this window> **SAVE**

  <figure><img src="/files/t4vudNMBSyXHjA98x8lA" alt=""><figcaption></figcaption></figure>

* Data of BOT API Token will be hidden on the Edit form<br>

  <figure><img src="/files/6yCqRtE88yVHoJ4oEHxD" alt=""><figcaption></figcaption></figure>

**Fields explanation:**

*<mark style="color:blue;">**Name:**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">The name of the contact destination.</mark>*&#x20;

*<mark style="color:blue;">**Integration:**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">The channel where users can receive alerts. In this version, there are 3 channels available: Email and telegram.</mark>*&#x20;

*<mark style="color:blue;">**BOT API Token:**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">Token to access the BOT API</mark>*

*<mark style="color:blue;">**Chat ID:**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">Group Chat ID of Telegram</mark>*

*<mark style="color:blue;">**Optional Webhook Settings:**</mark>*

*<mark style="color:blue;">+ Disable Web Page Preview: If this option is checked, a Web Page Preview will be hidden on the notification content.</mark>*

*<mark style="color:blue;">+ Disable resolve message: A "resolved" notification will not be sent if this option is checked.</mark>*

* After completed, the Alert Contact Destination will show as below:

<figure><img src="/files/AqTSOVhs1RYLXitC3Sc9" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="III. Creating an Alert Rule using the Telegram notification channel" %}
**Step 1:** Login HI GIO cloud > Monitor

**Step 2:** Select Manage, and Select **NEW** below the ***Alert Rules*** section.

<figure><img src="/files/D3KSI7R3zPcFtTXVBBIY" alt=""><figcaption></figcaption></figure>

* A New Alert Rule window will open.
* Fill up the information in this window and select Alert Contact Destination using the Telegram notification channel > **SAVE**

<figure><img src="/files/XSmCZdXKAsY8Old6k77o" alt=""><figcaption></figcaption></figure>

* After it is completed, the alert rule will show as below:

<figure><img src="/files/bnpbo9jRYrFYzRvMB5k7" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="IV. Notification Telegram" %}
Whenever the threshold defined in the alert rule is reached, we will receive a Telegram notification indicating the Firing Instances or Resolved Instances.

* Sample Telegram – Firing Instance

<figure><img src="/files/D66odTlZjHLEKtQ7e99k" alt=""><figcaption></figcaption></figure>

* Sample Telegram – Resolved Instance

<figure><img src="/files/rxGspVFAjAUmu3pWFXws" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.higiocloud.vn/management/1.-iam-portal/hi-gios-monitoring-alert-telegram-notification-channel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.