mirror of
https://github.com/crazy-max/diun.git
synced 2026-01-03 19:45:05 +01:00
43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
# Telegram notifications
|
|
|
|
Notifications can be sent via Telegram using a [Telegram Bot](https://core.telegram.org/bots).
|
|
|
|
Follow the [instructions](https://core.telegram.org/bots#6-botfather) to set up a bot and get it's token.
|
|
|
|
Message the [GetID bot](https://t.me/getidsbot) to find your chat ID.
|
|
Multiple chat IDs can be provided in order to deliver notifications to multiple recipients.
|
|
|
|
## Configuration
|
|
|
|
!!! example "File"
|
|
```yaml
|
|
notif:
|
|
telegram:
|
|
token: aabbccdd:11223344
|
|
chatIDs:
|
|
- 123456789
|
|
- 987654321
|
|
```
|
|
|
|
| Name | Default | Description |
|
|
|--------------------|---------------|---------------|
|
|
| `token` | | Telegram bot token |
|
|
| `tokenFile` | | Use content of secret file as Telegram bot token if `token` not defined |
|
|
| `chatIDs` | | List of chat IDs to send notifications to |
|
|
| `chatIDsFile` | | Use content of secret file as chat IDs if `chatIDs` not defined |
|
|
|
|
!!! abstract "Environment variables"
|
|
* `DIUN_NOTIF_TELEGRAM_TOKEN`
|
|
* `DIUN_NOTIF_TELEGRAM_TOKENFILE`
|
|
* `DIUN_NOTIF_TELEGRAM_CHATIDS` (comma separated)
|
|
* `DIUN_NOTIF_TELEGRAM_CHATIDSFILE`
|
|
|
|
!!! example "chat IDs secret file"
|
|
Chat IDs secret file must be a valid JSON array like: `[123456789,987654321]`
|
|
|
|
## Sample
|
|
|
|
|
|
|
|
[^1]: Value required
|