# Telegram Integration

[Telegram](https://telegram.org/) is a cloud-based instant messaging app that allows users to send messages, photos, videos, and files to individuals or groups. It is known for its emphasis on privacy and security, offering end-to-end encryption for secret chats.

{% hint style="info" %}
To use our Telegram outbound integration, a valid phone number contact in the notification settings in ilert is required. Simply add a phone number by following [our notification settings guide](https://docs.ilert.com/alerting/notification-settings#add-notification-contacts-and-activate-supported-channels).
{% endhint %}

## In ilert: Activate Telegram in the notification settings <a href="#alarm-sources" id="alarm-sources"></a>

1. Click on the **avatar icon -> Notification settings**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FX3R8EOOnEFGAt0DkSF0L%2Filert-1.png?alt=media&#x26;token=4a9b3845-9cc2-4eee-915e-d55e619a413e" alt="" width="563"><figcaption></figcaption></figure>

2. In **Phone number contacts,** click on **Activate** next to Telegram.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdeOeE1KS85v7t3Fe6eiW%2Filert-2.png?alt=media&#x26;token=9c3d306b-b165-49f0-932d-1e99802b5ee4" alt="" width="563"><figcaption></figcaption></figure>

3. Copy the code that was generated in the pop-up or click on **Verify**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyOw655FwFYEP4bzWcKL6%2Filert-3.png?alt=media&#x26;token=8d2720b7-17fd-4d50-a55c-9d72f162e6c3" alt="" width="563"><figcaption></figcaption></figure>

4. Now click on **Send Message**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FoyKXlRn9CPPPasHS6C1l%2Fbrowser-1.png?alt=media&#x26;token=a69135f3-ac10-4d50-a033-9215d8dd0e63" alt="" width="563"><figcaption></figcaption></figure>

5. You will then be verified.
6. Send a test notification to test your connection by clicking on **Send test notification.**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F0qrG5bnXZyzm2cnoEKpl%2Filert-4.png?alt=media&#x26;token=c98a7933-b745-4b3c-9b55-0d97a63d2ab8" alt="" width="563"><figcaption></figcaption></figure>

## Optional: Activate the ilert connection in Telegram manually <a href="#alarm-sources" id="alarm-sources"></a>

To manually activate your Telegram connection, follow these steps.

1. Search for '@ilert\_bot' and open a new chat.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FyVAd78qh7NRCC3ptHnYr%2Ftelegram-4.png?alt=media&#x26;token=4b1d404a-830a-4f25-a596-bee535c13a6a" alt="" width="563"><figcaption></figcaption></figure>

2. Enter the previously generated verification code into the Chat.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FLphjSijT0z4UvecDQ4Nn%2Ftelegram-1.png?alt=media&#x26;token=08a2ec58-8c9f-4449-85ee-a6372a3c463e" alt="" width="561"><figcaption></figcaption></figure>

## In Telegram: ilert alert action in Telegram groups <a href="#alarm-sources" id="alarm-sources"></a>

1. Add our '@ilert\_actions\_bot' into a group of choice.
2. If the '@ilert\_actions\_bot' got invited successfully, you will receive a message with a code starting with a dash("-"). Copy this code and proceed to the [next step](#alarm-sources-3).

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FOtLFsnUrAmuL6TwGmCwE%2Ftelegram-3.png?alt=media&#x26;token=10b12cd8-98d3-4331-97f1-1ccdc8257c43" alt="" width="563"><figcaption></figcaption></figure>

## In ilert: Create a new Telegram alert action <a href="#alarm-sources" id="alarm-sources"></a>

1. Click on **Alert sources -> Alert actions**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F6OYGwiTkbZcI18AP3sYs%2Filert-5.png?alt=media&#x26;token=eaf3a355-dfa3-42a8-aa8b-44a598b2af17" alt="" width="563"><figcaption></figcaption></figure>

2. Now click on **Create new alert action**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FaoqfFprX2jTb6Pt9GEge%2Filert-6.png?alt=media&#x26;token=e4a6e138-30e7-4a92-bcf9-e497cb34cfed" alt="" width="563"><figcaption></figcaption></figure>

3. Search for **Telegram** in the alert actions wizard and select our Telegram integration.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FIWuPJ2ZBFLUmsZRMwIFC%2Filert-7.png?alt=media&#x26;token=4c942223-7aa2-41d2-a694-f34ce701ac09" alt="" width="563"><figcaption></figcaption></figure>

4. Enter a **Name** and proceed to the next step.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fxfa8gBx9VXF3XSAt2ei3%2Filert-8.png?alt=media&#x26;token=93f1f241-97c3-4f40-a478-b3c2957e398e" alt="" width="563"><figcaption></figcaption></figure>

5. Choose some alert event filters for your alert action and click on **Next**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fg2LVjlMdFmomW5xGEnwI%2Filert-9.png?alt=media&#x26;token=08c16b7d-974c-4b91-8427-1cc25145bf9e" alt="" width="563"><figcaption></figcaption></figure>

6. Now enter the **code** from [this step](#alarm-sources-3) that you have received from our ''@ilert\_actions\_bot" in your Telegram group and click on **Done** to finish the setup.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNsUDfU7zZvqhZY4QJjn9%2Filert-10.png?alt=media&#x26;token=b0f4e33a-6ce6-45d1-b3a3-ce6f72684a97" alt="" width="563"><figcaption></figcaption></figure>
