Telegram chatbot webhooks implementation as described in the Telegram documentation.
setWebhook method your bot’s webhook URL should be set to
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.
To integrate this into Home Assistant, add the following section to your
# Example configuration.yaml entry http: base_url: <public_url> # the Home Assistant https url which is exposed to the internet. telegram_bot: - platform: webhooks api_key: telegram api key parse_mode: html allowed_chat_ids: - 12345 - 67890
- allowed_chat_ids (Required): A list of ids representing the users and group chats that are authorised to interact with the webhook.
- api_key (Required): The API token of your bot.
- trusted_networks (Optional): Telegram server access ACL as list. Defaults to
- parse_mode (Optional): Default parser for messages if not explicit in message data: ‘html’ or ‘markdown’. Default is ‘markdown’.
- proxy_url (Optional): Proxy url if working behind one (
- proxy_params (Optional): Proxy configuration parameters, as dict, if working behind a proxy (
- url (Optional): Allow to overwrite the
httpcomponent for different configurations (
To get your
api_key follow the instructions here. As well as authorising the chat, if you have added your bot to a group you will also need to authorise any user that will be interacting with the webhook. When an unauthorised user tries to interact with the webhook Home Assistant will raise an error (“Incoming message is not allowed”), you can easily obtain the the users id by looking in the “from” section of this error message.
Full configuration sample:
# Example configuration.yaml entry http: base_url: <public_url> telegram_bot: - platform: webhooks api_key: ABCDEFGHJKLMNOPQRSTUVXYZ trusted_networks: - 126.96.36.199/32 - 188.8.131.52/31 - 184.108.40.206/29 - 220.127.116.11/28 - 18.104.22.168/29 - 22.214.171.124/31 allowed_chat_ids: - 12345 - 67890