# Telegram Notification

**URL:** <https://community.graylog.org/t/telegram-notification/22693>\
**Category:** Plug-Ins\
**Tags:** plug-in\
**Created:** [February 17, 2022, 7:23pm UTC](https://community.graylog.org/t/telegram-notification/22693 "2022-02-17T19:23:55Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![dscryber](https://sea2.discourse-cdn.com/flex016/user_avatar/community.graylog.org/dscryber/32/14178_2.png) [@dscryber](https://community.graylog.org/u/dscryber)\
**Post date:** [February 17, 2022, 7:23pm UTC](https://community.graylog.org/t/telegram-notification/22693/1 "2022-02-17T19:23:55Z")

</div>

# [Telegram Notification](https://marketplace.graylog.org/addons/8a67cfdf-8c1c-4d17-87bf-db38e79015f1)

@irgendwr

[Download from Github](https://github.com/irgendwr/TelegramAlert/releases/tag/v2.3.7)  
[View on Github](https://github.com/irgendwr/TelegramAlert)  
[Issues](https://github.com/irgendwr/TelegramAlert/issues)  
[Stargazers](https://github.com/irgendwr/TelegramAlert/stargazers)

### Plugin v2.3.7

🔔 Telegram Notification Plugin for Graylog

- [alarm](https://marketplace.graylog.org/addons?tag=alarm)
- [telegram](https://marketplace.graylog.org/addons?tag=telegram)
- [notifications](https://marketplace.graylog.org/addons?tag=notifications)
- [plugin](https://marketplace.graylog.org/addons?tag=plugin)
- [alert](https://marketplace.graylog.org/addons?tag=alert)
- [notification](https://marketplace.graylog.org/addons?tag=notification)

# TelegramNotification Plugin for Graylog

[![Build status](https://github.com/irgendwr/TelegramAlert/workflows/build/badge.svg)](https://github.com/irgendwr/TelegramAlert/actions?query=workflow%3Abuild) [![GitHub Release](https://camo.githubusercontent.com/b39a8e6b95ccb7729de92db06f2e44efdffdd4662d8fff0aa94e9e210b1cdc17/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f697267656e6477722f54656c656772616d416c6572742e737667)](https://github.com/irgendwr/TelegramAlert/releases) [![Graylog Marketplace](https://camo.githubusercontent.com/265ba340ab7b7009e987eb0fcfb33432c029554c0cc0da4e65ae9f44759c7b4f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f477261796c6f672d4d61726b6574706c6163652d626c75652e737667)](https://marketplace.graylog.org/addons/8a67cfdf-8c1c-4d17-87bf-db38e79015f1) [![Donate](https://camo.githubusercontent.com/a13b8eaa9102a8f165f5c9e4d864d1e29876d33b6fd12bf0e5a4bcfdef671e43/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50617950616c2d446f6e6174652d626c75652e737667)](https://paypal.me/jonasboegle)

TelegramNotification allows you to send [Graylog](https://www.graylog.org/) alert messages to a specified [Telegram](https://telegram.org/) chat.

## Requirements

Requires Graylog 3.1 or later. It’s recommended to use the [latest Graylog release](https://www.graylog.org/products/latestversion).

## Installation

1. Download the [latest TelegramNotification release](https://github.com/irgendwr/TelegramAlert/releases/latest) and place the `graylog-plugin-telegram-notification-x.x.x.jar` file in your `plugin_dir` that is configured in your `graylog.conf` as described in the [Graylog documentation](http://docs.graylog.org/en/latest/pages/plugins.html#installing-and-loading-plugins).
2. Restart your graylog-server, i.e. `systemctl restart graylog-server` .
3. Configure an alert notification as described in the next section.

## Usage

### Step 1 - Create Bot

Create a new Telegram bot with the [BotFather](https://t.me/BotFather) and copy the bot token.

### Step 2 - Get Channel ID

Use the [Message Tool](https://irgendwr.github.io/TelegramAlert/message-tool) to find the **Chat ID** of the desired chat.

You can use a private chat, add the bot to a group-chat or to a channel. Just make sure to copy the correct Channel ID.

### Step 3 - Add Notification

Navigate to **Alerts \> Notifications** in your Graylog-interface and select `Telegram Notification` as the notification type.

The message is a template that can be configured as described in the [Graylog Documentation](https://docs.graylog.org/en/latest/pages/alerts.html#email-alert-notification)

[![Settings](https://us1.discourse-cdn.com/flex016/uploads/graylog/original/2X/a/a4e2f338893642e8c3763d499f332af3774d3306.png)](https://raw.githubusercontent.com/irgendwr/TelegramAlert/master/screenshots/settings.png)

## Update

To update the plugin you need to remove the old `graylog-plugin-telegram-notification-x.x.x.jar` (or `telegram-alert-x.x.x.jar` ) file from your plugins folder and follow the [installation](https://marketplace.graylog.org/addons/8a67cfdf-8c1c-4d17-87bf-db38e79015f1#Installation) instructions again.

You may need to remove and re-create your Telegram Notifications.

## Development

See [development/README.md](https://marketplace.graylog.org/addons/development/README.md) for some notes on how to get started with development.

Contributions are welcome.

## Credits

Thanks to:

- Alexey Medov (@kakogoxepa) - _for his valuable ideas and generous donation!_
- Everyone that [starred this repository](https://github.com/irgendwr/TelegramAlert/stargazers) ⭐ - _you keep me motivated_ 🙂
- [Contributors](https://github.com/irgendwr/TelegramAlert/graphs/contributors) that submitted useful [pull-requests](https://github.com/irgendwr/TelegramAlert/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aclosed+is%3Amerged) or opened good issues with suggestions or a detailed bug report.