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
  - platform: polling
    api_key: YOUR_API_KEY
      - 12345
      - 67890

Configuration Variables

allowed_chat_ids listRequired

A list of users in the user_id Telegram format that are authorized to interact with the webhook.

api_key stringRequired

The API token of your bot.

parse_mode string(Optional, default: markdown)

Default parser for messages if not explicit in message data, either html or 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.