mirror of
https://github.com/caronc/apprise.git
synced 2024-12-13 10:21:51 +01:00
Created Notify_telegram (markdown)
parent
0359e0c5d6
commit
91fe74077f
33
Notify_telegram.md
Normal file
33
Notify_telegram.md
Normal file
@ -0,0 +1,33 @@
|
||||
## Telegram Notifications
|
||||
* **Source**: https://telegram.org/
|
||||
* **Icon Support**: No
|
||||
* **Message Format**: Text
|
||||
* **Message Limit**: 4096 Characters per message
|
||||
|
||||
### Account Setup
|
||||
Telegram is slightly more complicated then some of the other notification services, so here is quick breakdown of what you need to know and do in order to send Notifications through it using this tool:
|
||||
|
||||
First off, Telegram notifications require you need to first access https://api.telegram.org and create a bot. After creating te bot, you will need to acquire it's Token Identifier (*bot_token*).
|
||||
|
||||
To do this you will be required in a chat with the **[BotFather](https://botsfortelegram.com/project/the-bot-father/)** to type: ```/newbot```. Answer the questions it asks after doing this (which get the name of it, etc). When you've completed this step, you will be provided an *bot_token* that looks something like this: ```123456789:alphanumeric_characters```.
|
||||
|
||||
### Syntax
|
||||
Valid are as follows:
|
||||
* **tgram**:://**{bot_token}**/**{chat_id}**/
|
||||
* **tgram**:://**{bot_token}**/**{chat_id1}**/**{chat_id2}**/**{chat_id3}**/
|
||||
|
||||
This can also be written like so:
|
||||
* **tgram**:://**{chat_id}**@**{bot_token}**/
|
||||
|
||||
### Parameter Breakdown
|
||||
| Variable | Required | Description
|
||||
| ----------- | -------- | -----------
|
||||
| bot_token | Yes | The token that identifies the bot you created through the *[BotFather](https://botsfortelegram.com/project/the-bot-father/)*
|
||||
| chat_id | Yes | Identify the users you want your bot to deliver your notifications to. You must specify at least 1 *chat_id*.
|
||||
|
||||
#### Example
|
||||
Send a telegram notification to lead2gold:
|
||||
```bash
|
||||
# Assuming our {bot_token} is 123456789:abcdefg_hijklmnop
|
||||
notify tgram:///123456789:abcdefg_hijklmnop/lead2gold/
|
||||
```
|
Loading…
Reference in New Issue
Block a user