Update Telegram Webhook docs (#15121)

This commit is contained in:
Gerard 2020-10-09 16:48:27 +02:00 committed by GitHub
parent 26334d93bd
commit 5165b6b405
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -4,14 +4,16 @@ description: "Telegram webhooks support"
ha_category:
- Notifications
ha_release: 0.42
ha_iot_class: Cloud Push
ha_domain: telegram_bot
---
Telegram chatbot webhooks implementation as described in the Telegram [documentation](https://core.telegram.org/bots/webhooks).
Using Telegrams `setWebhook` method your bot's webhook URL should be set to `https://<public_url>:<port>/api/telegram_webhooks`.
By default this integration sets your bot's webhook URL automatically to `https://<external_url>/api/telegram_webhooks` with the external_url of your Home Assistant [configuration](/docs/configuration/basic/) using Telegrams `setWebhook` method.
This is one of two bot implementations supported by Telegram. Described by Telegram as the preferred implementation but requires your Home Assistant instance to be exposed to the internet.
The other implementation method is [Telegram polling](/integrations/telegram_polling/), for which your Home Assistant instance does not have to be exposed to the internet.
## Configuration
@ -22,15 +24,14 @@ To integrate this into Home Assistant, add the following section to your `config
telegram_bot:
- platform: webhooks
api_key: YOUR_API_KEY
parse_mode: html
allowed_chat_ids:
- 12345
- 67890
- 123456789 # example id of a user
- -987654321 # example id of a group, starts with a -
```
{% configuration %}
allowed_chat_ids:
description: A list of ids representing the users and group chats that are authorized to interact with the webhook.
description: A list of ids representing the users and group chats that are authorized to interact with the bot.
required: true
type: list
api_key:
@ -72,10 +73,11 @@ The configuration sample below shows how an entry can look like:
telegram_bot:
- platform: webhooks
api_key: YOUR_API_KEY
parse_mode: html
trusted_networks:
- 149.154.160.0/20
- 91.108.4.0/22
allowed_chat_ids:
- 12345
- 67890
- 123456789 # example id of a user
- -987654321 # example id of a group, starts with a -
```