Telegram bot in Home Assistant
telegram_bot
part of Home Assistant since 0.42
Telegram bot is an official Home Assistant integration for Notifications. Works through the manufacturer’s cloud; changes arrive straight away, but only while the internet connection and the service are up.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Cloud, push – Works through the manufacturer’s cloud; changes arrive straight away, but only while the internet connection and the service are up.
- Setup
- in the user interface
- Kind
- Online service
- Quality scale
- Gold – Very good user experience: set up in the interface, discovered automatically, documented in detail.
- Installations
- 26,574 (3.9 % of the installations that share statistics)
- Categories
- Notifications
- Provides
- Diagnostics, Event, Notifications
- Maintained by
- @hanwg
- Python packages
python-telegram-bot[socks]==22.7
Setup
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for Telegram bot.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Blueprints that use this integration
- Automation Frigate Notifications (0.14.0.3l)
- Automation Telegram Bot: Conversation with Assist
- Automation Frigate - Telegram Notification
- Automation Bambu Lab 3D Printer Cost Notification
- Automation Automatic door unlock
- Automation Telegram Bot: Respond to Telegram Command with a text message
Known issues and fixes
3 open issues and 18 bug fixes in the last twelve months are recorded for Telegram bot in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.9.0.
Open
- open Reported problem #156182
- open Reported problem #178525
- open Reported problem #171508
Fixed
- fixed in 2026.9.0 Bug fix #180519
- fixed in 2026.5.0 Bug fix #169519
- fixed in 2026.2.2 Bug fix #162762
- fixed in 2026.2.2 Bug fix #162555
- fixed in 2025.11.0 Bug fix #155510
Source: the issue tracker of Home Assistant, as of September 14, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration