Telegram Bot To‑Do List

Telegram To‑do List – Reply Keyboard + Inline Buttons

Update — Telegram To-do List (HA 2026.04)

This automation blueprint lets you manage any Home Assistant to‑do list directly from a Telegram chat. It combines a friendly reply keyboard (bottom of the chat) with powerful inline buttons on the main list message.

This is the first attempt at creating a blueprint, so there may still be rough edges. If you run into any issues or unexpected behavior, please post in the thread and they will be addressed as soon as possible.

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

Support Development


Features

  • Inline keyboard with edit_message (clean chat, no spam)
  • Active / All list views
  • Automatic appearance of Clear completed button
  • Duplicate protection (case- and space-insensitive)
  • Reopen completed items with one tap
  • Add multiple items in a single message using , or .
  • Works with any Home Assistant todo.* entity
  • Blueprint-only solution (no hardcoded entity IDs)
  • Compatible with Home Assistant 2025.12+

How it works

  1. Send /start or /list to the bot
  2. Add items by sending plain text
  3. Use inline buttons to complete or reopen items
  4. Switch between Active and All views
  5. Clear completed items when needed

Example:

milk, bread. eggs

Requirements

  • Home Assistant 2025.12 or newer
  • Telegram Bot integration
  • At least one To-do entity

Why this blueprint?

This blueprint focuses on usability and reliability:

  • No custom components
  • No Node-RED
  • No external scripts
  • Predictable behavior
  • Safe logic (no loops, no race conditions)

Just import the blueprint, select your To-do entity, Telegram chat_id (Use this bot to get ID, Config Entry ID (Settings → Devices & Services → Integrations →Telegram Bot → ⋮ Copy Config Entry ID
), and start using it.

2 Likes

Update!

What changed

  • Completed items in the “:scroll: Show all / History (all items)” view now use a ☑️ button with an action that restores them to active status instead of doing nothing.
  • When you tap a completed item’s button, the blueprint updates that to‑do entry from completed back to needs_action, so it reappears in the active list view.
  • The callback‑handling logic was extended to recognize a new /reopen_<uid> action and respond with a short confirmation message (“Active again”) when an item is reactivated.
  • Also added condition to check bot config entry ID(for more then 2 bots integrations)

Update!

Description of changes

1. Multiple chat support

  • The telegram_chat_id input now uses a text selector with multiple: true, allowing you to specify more than one chat ID.
  • The automation checks whether the incoming chat_id is in the configured list and only then proceeds.
  • All replies (send, edit, delete) now use trigger.event.data.chat_id, so the bot always responds in the same chat where the message, command, or callback originated.

2. Bot instance filtering

  • A global condition compares trigger.event.data.bot.config_entry_id with the blueprint input bot_config_entry_id.
  • This ensures the automation only reacts to events from the specific Telegram bot instance selected in the blueprint, which is essential when multiple Telegram bots are configured.

Update!

Full refactoring
Working with 2026.1

Да — для Home Assistant Community в Blueprints Exchange обычно любят сухой release-note стиль. Вот версия в этом формате:


Update — Telegram To-do List (HA 2026.04)

Breaking Changes

Telegram bot event filtering added

This blueprint now validates both:

  • chat_id
  • config_entry_id

If you use multiple Telegram bot integrations, this prevents messages from other bots from triggering this automation.

Migration Required

If updating manually, ensure your condition includes:

trigger.event.data.config_entry_id == bot_id

Migration Notes

Deprecated Telegram parameter updated

Home Assistant deprecated:

target:

This blueprint now uses:

chat_id:

If you modified the blueprint locally, update custom telegram_bot.send_message actions accordingly.


Improvements

  • Improved English localization

  • Updated button labels:

    • View List
    • Remove Completed
    • All Items
    • Active Items
  • Updated callback confirmation:

    • DoneUpdated
  • Improved duplicate warning text

  • Reduced duplicated internal logic

  • Improved compatibility with Home Assistant 2026.04+


Features

  • Telegram reply keyboard
  • Inline buttons (edit_message)
  • Active / All Items view
  • Remove completed items
  • Duplicate protection
  • Reopen completed items
  • Multi-item input via , or .
  • Bot instance isolation for multi-bot setups