From 5165b6b405d96143343aaaf5958841f8362ccf3d Mon Sep 17 00:00:00 2001 From: Gerard Date: Fri, 9 Oct 2020 16:48:27 +0200 Subject: [PATCH] Update Telegram Webhook docs (#15121) --- source/_integrations/telegram_webhooks.markdown | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/source/_integrations/telegram_webhooks.markdown b/source/_integrations/telegram_webhooks.markdown index 269ebd22990..4d9857f35aa 100644 --- a/source/_integrations/telegram_webhooks.markdown +++ b/source/_integrations/telegram_webhooks.markdown @@ -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://:/api/telegram_webhooks`. +By default this integration sets your bot's webhook URL automatically to `https:///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 - ```