aboutsummaryrefslogtreecommitdiffstats
path: root/doc/mod/notification-telegram.md
diff options
context:
space:
mode:
authorGravatar Christian Hesse <mail@eworm.de>2022-02-21 12:54:01 +0100
committerGravatar Christian Hesse <mail@eworm.de>2022-02-21 12:54:01 +0100
commit343ee27820c3e5e82e2a0a8ab7899f7059cf370e (patch)
tree5dfacbc9123c44afbe4a5a79d6f9632d4c1ab77b /doc/mod/notification-telegram.md
parent886cd67edba86906fea4c0d753b13b7c68c5e78b (diff)
parentd74aac8f6ad3edfdf65d4a3ee6714aae1d3ade0f (diff)
Merge branch 'doc/mod' into next
Diffstat (limited to 'doc/mod/notification-telegram.md')
-rw-r--r--doc/mod/notification-telegram.md63
1 files changed, 63 insertions, 0 deletions
diff --git a/doc/mod/notification-telegram.md b/doc/mod/notification-telegram.md
new file mode 100644
index 0000000..435694e
--- /dev/null
+++ b/doc/mod/notification-telegram.md
@@ -0,0 +1,63 @@
+Send notifications via Telegram
+===============================
+
+[◀ Go back to main README](../../README.md)
+
+> ℹ️️ **Info**: This module can not be used on its own but requires the base
+> installation. See [main README](../../README.md) for details.
+
+Description
+-----------
+
+This module adds support for sending notifications via
+[Telegram](https://telegram.org/) via bot api. A queue is used to make sure
+notifications are not lost on failure but sent later.
+
+Requirements and installation
+-----------------------------
+
+Just install the module:
+
+ $ScriptInstallUpdate mod/notification-telegram;
+
+Also install Telegram on at least one of your mobile and/or desktop devices
+and create an account.
+
+Configuration
+-------------
+
+Open Telegram, then start a chat with [BotFather](https://t.me/BotFather) and
+create your own bot:
+
+![create new bot](notification-telegram.d/newbot.avif)
+
+Now open a chat with your bot and start it by clicking the `START` button.
+
+Open just another chat with [GetIDs Bot](https://t.me/getidsbot), again start
+with the `START` button. It will send you some information, including the
+`id`, just below `You`.
+
+Finally edit `global-config-overlay`, add `TelegramTokenId` with the token
+from *BotFather* and `TelegramChatId` with your id from *GetIDs Bot*. Then
+reload the configuration.
+
+### Notifications to a group
+
+Sending notifications to a group is possible as well. Add your bot and the
+*GetIDs Bot* to a group, then use the group's id (which starts with a dash)
+for `TelegramChatId`. Then remove *GetIDs Bot* from group.
+
+Usage and invocation
+--------------------
+
+There's nothing special to do. Every script or function sending a notification
+will now send it to your Telegram account.
+
+See also
+--------
+
+* [Send notifications via Matrix](notification-matrix.md)
+
+---
+[◀ Go back to main README](../../README.md)
+[▲ Go back to top](#top)