> For the complete documentation index, see [llms.txt](https://manual.selarti.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.selarti.com/manual-en/external-integrations/telegram-notifications-for-dialog-statuses.md).

# Telegram Notifications for Dialog Statuses

*The «Telegram notifications» integration allows you to configure sending notifications to Telegram about important customer messages — about new orders and questions. The integration works without using additional external services or complex settings.*

{% hint style="warning" %}
Important! For notifications to work, you must start the bot @selarti\_bot in Telegram by clicking «Start» in a private chat with it.
{% endhint %}

Before setting up the integration, first obtain the chat ID in Telegram for receiving notifications:

* For sending notifications to private messages: Start this [bot](https://t.me/myidbot), send the command /getid and copy the Telegram ID shown after «Your own ID is:».
* For sending notifications to a group chat: Add the [ID bot](https://t.me/myidbot) to the group, send the command /getgroupid\@myidbot to the chat, copy the Telegram ID shown after «Your group ID is:»; afterwards, you can remove the ID bot from the group. Add [selarti\_bot](https://t.me/selarti_bot) to the chat.

Next, in your [Selarti personal account](https://selarti.com/panel?menu=integration), go to the «Integration» section and click the «Create Integration» button in the upper right corner of the screen. From the dropdown list, select the «Telegram notifications» type.

<figure><img src="/files/7aQED8qKl5gdidQkdRLP" alt=""><figcaption></figcaption></figure>

In the «Name» field, assign a convenient name. In the «Telegram ID (user/chat/channel)» field, specify the chat ID where notifications should be sent: your personal Telegram ID (for receiving messages in private messages) or the ID of the group chat where you added the @selarti\_bot.

<figure><img src="/files/0EhnGVttLIt3epqfokld" alt=""><figcaption></figcaption></figure>

In the window below, edit the notification text for your convenience. Variables are indicated after the text. You can use all variables or delete the unnecessary ones.

Available variables:

* {event\_type} — The dialog status (e.g., «Successful», «Interest», «Contact Received», «Operator»).
* {thread\_name} — The contact's name from the account.
* {thread\_contact} — Contact details (phone, ID). For Telegram chats, you can add «@» to create a clickable link: @{thread\_contact}.
* {share\_url} — A link to view the dialog, which can be accessed by anyone with whom this link is shared.
* {panel\_url} — An administrative link for admins to view and join the dialog.

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

{% hint style="info" %}
Example of a ready-made template:

Alert!
\
Success or Interest — {event\_type}
\
Name — {thread\_name}
\
Contact — @{thread\_contact}
\
Link to view the dialog — {share\_url}
{% endhint %}

Click «Send a test notification» to make sure the message arrives in the desired format.

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

A test notification with the selected variables will be sent to Telegram.

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

Select for which dialog statuses you want to receive notifications. Click «Create integration».

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

{% hint style="warning" %}
Important: You must add the created integration to the relevant task for notifications to start arriving. Read more about [Tasks](/manual-en/main-sections-of-the-service/tasks.md).
{% endhint %}