# 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="/files/5pjHemOVmdXBXXbXlLqR" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/yeCRlv2uAfpN1zrwimAb" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/moVzFj75GSlaMsz67J48" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/E7JbMtwgOJKxQ5u3DTWz" 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="/files/fsVO2T488aMHtkVY4wew" 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="/files/9UzHKfVUzcvfEGUkC9Ti" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/UaoohnWUuq2IWKmHxRGa" 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="/files/pZG7smGWV2dL7IOxxQGP" 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="/files/VKruMsO4FVgdTaCqeLpI" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/GqFTQKmGgfROjBy6cIDf" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/vI2IneLktoiZqqs8SQXo" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/OaLBBmbJ6gk62txAQ2P6" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/mNj3sFLcqZYhecrPaKyE" 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="/files/QiGjoLk3ZyqtYwtuXuIq" alt="" width="563"><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://docs.ilert.com/integrations/outbound-integrations/telegram.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.