alexei.dolgolyov/haos-hacs-immich-album-watcher

Files

Validate / Hassfest (push) Has been cancelled

Details

Add Phase 10 plan: Telegram bot commands

15 commands across 4 categories:
- Informational: /status, /albums, /events
- On-demand: /summary, /latest, /memory, /random
- Asset browsing: /search, /favorites, /people
- Management: /trackers, /targets, /help

Auto-registers commands with Telegram setMyCommands API when
config changes. Per-bot command enable/disable in UI.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-19 18:05:12 +03:00

2.7 KiB

Raw Blame History

Phase 10: Telegram Bot Commands

Status: Pending Parent: primary-plan.md

Goal

Define and implement Telegram bot commands that users can invoke directly from chat to interact with the Immich Watcher system. The server auto-registers commands with Telegram's BotFather API whenever the command config changes.

Proposed Commands

Informational

/status — Show tracker status (active trackers, last event, server health)
/albums — List tracked albums with asset counts
/events [N] — Show last N events (default 5)

On-Demand Notifications

/summary — Trigger periodic summary now
/latest [album] — Show latest assets from an album (or all)
/memory — Trigger "On This Day" memory notification now
/random [album] — Send random photo(s) from an album

Asset Browsing

/search <query> — Search assets by filename, people, location
/favorites [album] — Show favorite assets
/people — List detected people across albums

Management

/trackers — List trackers with enable/disable toggle (inline buttons)
/targets — List notification targets
/help — Show available commands with descriptions

Tasks

1. Command registry model `[ ]`

New entity or config: list of enabled commands per bot
Admin can enable/disable individual commands per bot
Default set of commands enabled on bot registration

2. Auto-register commands with Telegram `[ ]`

Call setMyCommands API when commands config changes
Call on bot creation and on config update
Store command descriptions in i18n (EN/RU based on bot locale setting)

3. Webhook command handler `[ ]`

Extend existing webhook handler to route /command messages
Parse command + arguments
Execute corresponding logic (reuse existing services)
Return formatted response

4. Implement each command `[ ]`

/status, /albums, /events — read from DB
/summary, /memory, /latest, /random — call watcher/notifier services
/search, /favorites, /people — call Immich API via core client
/trackers, /targets — read from DB, optional inline keyboard for toggle
/help — auto-generated from enabled commands

5. Frontend: command config per bot `[ ]`

On telegram-bots page, expandable "Commands" section per bot
Checkboxes to enable/disable each command
Bot locale selector (for command descriptions language)
"Sync Commands" button (calls setMyCommands)

Acceptance Criteria

Commands registered with Telegram and visible in bot menu
Each command returns a useful response
Commands auto-sync when config changes
Admin can enable/disable commands per bot via UI

2.7 KiB Raw Blame History