mirror of
https://github.com/eworm-de/routeros-scripts
synced 2024-05-14 08:04:19 +00:00
819c7294c6
Druvis from Mikrotik produced a video "MikroTik Telegram bot - Chat with your Router?". He shows his script to chat with a Router via Telegram bot to send it commands: https://youtu.be/KLX6j3sLRIE This script is kind of limited and has several issues... 🥴 Let's make it robust, usable, multi-device capable and just fun! 😁 (Sadly Mikrotik has a policy to not allow links in Youtube comments. Thus my comment with several hints was removed immediately. If anybody is in contact with Druvis... Please tell him about this script!)
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
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:
|
||
|
||
|
||
|
||
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.
|
||
|
||
But of course you can send notifications directly or use a function in your
|
||
own scripts. Give it a try:
|
||
|
||
$SendTelegram "Subject..." "Body..."
|
||
|
||
Alternatively this sends a notification with all available and configured
|
||
methods:
|
||
|
||
$SendNotification "Subject..." "Body..."
|
||
|
||
See also
|
||
--------
|
||
|
||
* [Chat with your router and send commands via Telegram bot](../telegram-chat.md)
|
||
* [Send notifications via e-mail](notification-email.md)
|
||
* [Send notifications via Matrix](notification-matrix.md)
|
||
|
||
---
|
||
[⬅️ Go back to main README](../../README.md)
|
||
[⬆️ Go back to top](#top)
|