--- title: "Telegram bot" description: "Telegram bot is a built-in integration for Home Assistant. It has 27.4k installs sharing analytics and needs the vendor's cloud." canonical: "https://vulpo.app/integrations/core/telegram-bot" url: "https://vulpo.app/integrations/core/telegram-bot.md" last-updated: "2026-10-22" version: "1.4" --- # Telegram bot > Telegram bot is a built-in integration for Home Assistant. It has 27.4k installs sharing analytics and needs the vendor's cloud. Telegram bot is a built-in integration that connects Home Assistant to a Telegram bot through the Telegram cloud. It adds notifier and event entities, and an incoming update from Telegram is raised as an event that automations can react to. A broad set of actions covers sending messages, photos, videos, documents, voice messages, stickers, polls, locations and media groups. Sent messages can later be edited or deleted, including their caption, media and inline keyboard, and callback queries from keyboard buttons can be answered. Other actions download files to a local path, show a draft message while text is still being generated, and remove the bot from a chat. Setup happens in the UI with the bot's API token, and options include a platform choice, a default parse mode and trusted networks for webhooks. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=telegram_bot) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Change settings later**: Its connection settings can change without removing it. - **Gold quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up It is added under Settings, Devices and services, with Add integration. ### Connect - **API token**: The API token of your bot. - **Platform**: Telegram bot implementation - **API endpoint** - **Proxy URL** ### Webhooks network configuration - **Trusted networks**: Telegram server access ACL as list. Default: 149.154.160.0/20, 91.108.4.0/22 - **URL**: Allow to overwrite the external URL from the Home Assistant configuration for different setups. ### Re-authenticate Telegram bot - **API key**: The API token of your bot. ### Telegram bot setup - **Platform**: Telegram bot implementation - **API endpoint** - **Proxy URL** ### After setup - **Parse mode**: Default parse mode for messages if not explicit in message data. Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Events**: Update event ## Actions - **Answer callback query**: Responds to a callback query originated by clicking on an online keyboard button. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. Fields: Callback query ID, Config entry ID, Message, Show alert - **Delete message**: Deletes a previously sent message. Fields: Chat ID, Config entry ID, Notify target, Message ID - **Download file**: Download the file to a local path. Fields: Config entry ID, Directory path, File ID, File name - **Edit caption**: Edits the caption of a previously sent message. Fields: Caption, Chat ID, Config entry ID, Notify target, Inline keyboard, Message ID - **Edit message**: Edits a previously sent message. Fields: Chat ID, Config entry ID, Disable web page preview, Notify target, Inline keyboard, Message, Message ID, Parse mode, Title - **Edit message media**: Edits the media content of a previously sent message. Fields: Authentication method, Caption, Chat ID, Config entry ID, Notify target, File, Inline keyboard, Media type, Message ID, Password - **Edit reply markup**: Edits the inline keyboard of a previously sent message. Fields: Chat ID, Config entry ID, Notify target, Inline keyboard, Message ID - **Leave chat**: Removes the bot from the chat. Fields: Chat ID, Config entry ID, Notify target - **Send animation**: Sends an animation. Fields: Authentication method, Caption, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag - **Send chat action**: Sends a chat action. Fields: Chat action, Chat ID, Config entry ID, Notify target, Message thread ID - **Send document**: Sends a document. Fields: Authentication method, Caption, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag - **Send location**: Sends a location. Fields: Chat ID, Config entry ID, Disable notification, Notify target, Inline keyboard, Keyboard, Latitude, Longitude, Message tag, Message thread ID - **Send media group**: Sends a group of photos, videos, documents or audios as an album. Documents and audio files can only be grouped in an album with messages of the same type. Fields: Chat ID, Config entry ID, Disable notification, Notify target, Media, Message thread ID, Parse mode, Protect content, Reply to message ID - **Send message**: Sends a notification. Fields: Chat ID, Config entry ID, Disable notification, Disable web page preview, Notify target, Inline keyboard, Keyboard, Message, Message tag, Message thread ID - **Send message draft**: Shows a partial message (draft) in Telegram while the full message is still being generated. Fields: Chat ID, Config entry ID, Draft ID, Notify target, Message, Message thread ID, Parse mode - **Send photo**: Sends a photo. Fields: Authentication method, Caption, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag - **Send poll**: Sends a poll. Fields: Allow multiple answers, Chat ID, Config entry ID, Disable notification, Notify target, Is anonymous, Message thread ID, Open period, Options, Question - **Send sticker**: Sends a sticker. Fields: Authentication method, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag, Message thread ID - **Send video**: Sends a video. Fields: Authentication method, Caption, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag - **Send voice**: Sends a voice message. Fields: Authentication method, Caption, Chat ID, Config entry ID, Disable notification, Notify target, File, Inline keyboard, Keyboard, Message tag ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## At a glance - Kind: Built-in integration - Category: [Messaging and notifications](https://vulpo.app/integrations/category/messaging-and-notifications.md), Chat apps - Brand: [Telegram](https://vulpo.app/integrations/telegram.md) - Number: 27.4k installs sharing analytics - Connection: Needs the vendor's cloud - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Gold quality scale - Domain: `telegram_bot` - Source: In Vulpo: Entity card (read-only) ## Other ways in for Telegram | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Telegram](https://vulpo.app/integrations/core/telegram.md) | Built-in integration | 8.1k installs sharing analytics | Needs the vendor's cloud | Part of Home Assistant | | [Messenger for Whatsapp, Signal and Telegram](https://vulpo.app/integrations/marketplace/microteq-whatsigram-messenger.md) | Marketplace integration | 542 installs sharing analytics | Needs the vendor's cloud | No update in 6 to 18 months | | [Telegram client](https://vulpo.app/integrations/marketplace/lufton-ha-telegram-client.md) | Marketplace integration | 100 installs sharing analytics | Needs the vendor's cloud | No update in 6 to 18 months | | [Telegram Bot \<\> Conversation](https://github.com/Shulyaka/telegram_bot_conversation) | Marketplace integration | 19 installs sharing analytics | Works locally | Updated in the last 6 months | | [Telegram VoIP Calls](https://github.com/Sanji78/telegram_voip) | Marketplace integration | 13 installs sharing analytics | Works locally | No update in 6 to 18 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/telegram-bot --- - HTML version of this page: https://vulpo.app/integrations/core/telegram-bot - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml