Telegram polling


Telegram chatbot polling implementation.

One of two bot implementations supported by Telegram. Your Home Assistant does not have 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

telegram_bot:
  - platform: polling
    api_key: YOUR_API_KEY
    allowed_chat_ids:
      - 12345
      - 67890

Configuration Variables

allowed_chat_ids

(list)(Required)A list of user in the user_id Telegram format enabled to interact to webhook

api_key

(string)(Required)The API token of your bot.

parse_mode

(string)(Optional)Default parser for messages if not explicit in message data: ‘html’ or ‘markdown’.

Default value: markdown

proxy_url

(string)(Optional)Proxy url if working behind one (socks5://proxy_ip:proxy_port)

proxy_params

(string)(Optional)Proxy configuration parameters, as dict, if working behind a proxy (username, password, etc.)

To get your chat_id and api_key follow the instructions here.