Telegram client for Home Assistant (Marketplace integration)

Installs: 100 sharing analytics
GitHub stars: 17
Connection: Uses the vendor's cloud
Upkeep: No update in 6 to 18 months
Version: 1.0.2, June 25, 2025
Category: Messaging and notifications, Chat apps
Kind: Marketplace integration
Brand: Telegram
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: telegram_client
Source: github.com/lufton/ha_telegram_client
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Telegram client is a Marketplace integration that connects Home Assistant to Telegram as a client account or a bot. It relies on Telegram's cloud and is configured in the UI, where it asks for API credentials and either a phone number with a one time password or a bot token. It adds binary sensors and sensors to Home Assistant. The options let the user choose which events to listen for, including new, edited, read and deleted messages, callback queries, inline queries, chat actions and user updates. Each event type can be narrowed by chats, with a blacklist mode, and message events can also be filtered by direction, sender, forwards and a text pattern. Actions are provided to send, edit and delete messages.

Automatic summary of the code of lufton/ha_telegram_client. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

API parameters

API ID
API hash
Client type

Bot token

Token

OTP

One time password

Password

Password

Phone

Phone number

After setup

New message
Message edited
Message read
Message deleted
Callback query
Inline query
Chat action
User update
Chats
Blacklist mode (chats)
Incoming
Outgoing
From users
Forwards
Pattern
Chats
Blacklist mode (chats)
Incoming
Outgoing
From users
Forwards
Pattern
Chats
Blacklist mode (chats)
Inbox
Chats
Blacklist mode (chats)
Chats
Blacklist mode (chats)
Data
Pattern
Users
Blacklist mode (users)
Pattern
Chats
Blacklist mode (chats)

Actions

Send messagesFields: Telegram client, Target username, Target ID, Message, Reply to message id, Parse mode, Show link preview, File, Force document, Clear draft
Edit messageFields: Telegram client, Target username, Target ID, Message, Text, Parse mode, Show link preview, File, Force document, Keyboard
Delete messagesFields: Telegram client, Target username, Target ID, Message ID(s), Revoke