Перейти к содержимому
Управление чатами

Управление чатами

Команда chat управляет именованными идентификаторами чатов, групп и каналов — по аналогии с git remote. Вместо того чтобы каждый раз указывать числовой ID вроде -1001234567890, вы сохраняете его под понятным именем (alias) и используете это имя в --to.

Идентификаторы хранятся в базе SQLite ~/.config/tguser/tguser.db.

⚠️ Этот файл нельзя удалять. Вместе с ним пропадут все сохранённые имена чатов, а команды с --to <имя> перестанут работать; Telegram ваши локальные имена не хранит, поэтому справочник придётся собирать заново вручную. Подробнее — в 03. Конфигурация.

Обзор подкоманд

КомандаНазначение
tguser chat add <name> <chat_id>Добавить alias
tguser chat listПоказать все сохранённые чаты
tguser chat get-id <name>Вывести ID по имени
tguser chat replace-id <name> <new_id>Заменить ID
tguser chat rename <old> <new>Переименовать alias
tguser chat remove <name>Удалить alias

tguser chat без подкоманды равнозначно tguser chat list.

Добавить чат

tguser chat add work -1001234567890
╭────────────── ✓ Готово ──────────────╮
│ Добавлен чат work → -1001234567890   │
╰───────────────────────────────────────╯

В качестве chat_id можно сохранить:

  • числовой ID (для групп/каналов он отрицательный, например -1001234567890);
  • @username (например, @durov);
  • me — Избранное (сохранённые сообщения).

Отрицательные ID указываются как есть — экранировать ничего не нужно.

Автоматический резолв @username и ссылок

Если передать @username или ссылку (t.me/…, инвайт-ссылку t.me/+…) при активной сессии, tguser сам определит числовой ID и название и сохранит именно их:

tguser chat add news @somechannel
# Добавлен чат news → -1001234567890 (Some Channel)

Чтобы отключить резолв и сохранить значение как есть, добавьте --no-resolve:

tguser chat add news @somechannel --no-resolve

Не знаете ID или @username? См. 08. Обнаружение чатов — команды dialogs и resolve помогут найти ID, в том числе для закрытых чатов.

Список чатов

tguser chat list      # или просто: tguser chat
              Сохранённые чаты
┏━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Имя  ┃ ID чата        ┃ Название ┃ Создан           ┃
┡━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ work │ -1001234567890 │ —        │ 2026-06-30 11:20 │
└──────┴────────────────┴──────────┴──────────────────┘

Получить ID по имени

tguser chat get-id work
# -1001234567890

Удобно для скриптов: команда печатает только сам ID.

Заменить ID

tguser chat replace-id work -100999

Переименовать

tguser chat rename work team

Удалить

tguser chat remove team

Дальше

Как использовать сохранённые имена при отправке — в 05. Отправка сообщений.