# 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: 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://docs.higiocloud.vn/management/1.-iam-portal/hi-gios-monitoring-alert-telegram-notification-channel.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.