2025.3.4
首页 ▸ Integrations ▸

Telegram polling

Telegram chatbot polling implementation.

This is one of two bot implementations supported by Telegram. Your Home Assistant instance does not have to be exposed to the internet. The other implementation method is Telegram webhooks, described by Telegram as the preferred implementation but requires your Home Assistant instance to be exposed to the internet.

Configuration

To integrate this into Home Assistant, add the following section to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
telegram_bot:
  - platform: polling
    api_key: YOUR_API_KEY
    allowed_chat_ids:
      - 123456789 # example id of a user
      - -987654321  # example id of a group, starts with a -

Configuration Variables

Looking for your configuration file?
allowed_chat_ids list Required

A list of ids representing the users and group chats that are authorized to interact with the bot.

api_key string Required

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, optionally including username and password. (socks5://username:password@proxy_ip:proxy_port).

To get your chat_id and api_key follow the instructions here.