jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-04 10:08:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/telegram_bot.webhooks.markdown
Pascal Vizeli 910824dc3f Telegram change for 0.46 (#2736) 
* Update telegram_bot.webhooks.markdown

* Update telegram_bot.polling.markdown

* Update notify.telegram.markdown
2017-06-02 11:57:41 +02:00

2.0 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page Telegram webhooks Telegram webhooks support 2017-04-05 18:50 true false true true telegram.png Telegram chatbot 0.42

Telegram chatbot webhooks implementation as described in the Telegram documentation.

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 configuration.yaml file:

# 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

Configuration variables:

  • allowed_chat_ids (Required): A list of user in the user_id Telegram format enabled to interact to webhook
  • api_key (Required): The API token of your bot.
  • trusted_networks (Optional): Telegram server access ACL as list. Defaults to 149.154.167.197-233.
  • parse_mode (Optional): Default parser for messages if not explicit in message data: 'html' or 'markdown'. Default is 'markdown'.
  • url (Optional): Allow to overwrite the base_url from http component for diferent configs.

To get your chat_id and api_key follow the instructions here .

Full configuration sample:

# Example configuration.yaml entry
http:
  base_url: <public_url>

telegram_bot:
  - platform: webhooks
    api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
    trusted_networks:
      - 149.154.167.197/32
      - 149.154.167.198/31
      - 149.154.167.200/29
      - 149.154.167.208/28
      - 149.154.167.224/29
      - 149.154.167.232/31
    allowed_chat_ids:
      - 12345
      - 67890