Перейти к содержимому
Отправка сообщений

Отправка сообщений

tguser умеет отправлять текст и разные типы медиа от имени вашего аккаунта. Перед отправкой нужно войти в аккаунт.

Куда отправлять: цель (--to)

Цель — это получатель. Указывается через флаг --to или позиционно. Поддерживаются:

Вид целиПример
Имя сохранённого чата (alias)--to work
Числовой ID--to -1001234567890
Username--to @durov
Избранное (свои сообщения)--to me

Имена alias настраиваются командой chat — см. 04. Управление чатами. Не знаете числовой ID? См. 08. Обнаружение чатов.

Два синтаксиса

Все медиа-команды принимают аргументы двумя способами — выбирайте любой:

# через флаги
tguser sendphoto a.png b.png --to work --caption "Фотографии"

# позиционно
tguser sendphoto a.png b.png work "Фотографии"

Как разбираются позиционные аргументы: идущие подряд в начале токены, которые существуют как файлы на диске, считаются контентом; следующий токен — это цель (если не задан --to), а токен после него — подпись (если не задана --caption).

Поэтому если файла по указанному пути нет, он будет ошибочно принят за цель. Проверяйте пути.

Обзор команд

КомандаЧто отправляетПодпись (--caption)
sendТекстовое сообщение— (доп. текст)
sendfileФайл(ы) как документ✓
sendphotoФото (несколько — альбомом)✓
sendvideoВидео (несколько — альбомом)✓
sendaudioАудио / музыка✓
sendvoiceГолосовое сообщение✓
sendvideonoteВидео-кружок—
sendstickerСтикер (.tgs/.webp)—
sendcontactКонтакт—

Текст

tguser send "Привет!" --to work
tguser send "Привет!" work            # позиционно

Флаг --caption для текста необязателен; если он задан, его значение добавляется к сообщению через пустую строку:

tguser send "Заголовок" --to me --caption "Подробности ниже"

Файлы (документы)

tguser sendfile report.pdf --to work --caption "Отчёт"
tguser sendfile a.zip b.zip --to work          # несколько документов
tguser sendfile a.zip b.zip --to work --group  # сгруппировать в альбом

Без --group документы отправляются отдельными сообщениями. С флагом -G/--group несколько документов отправляются одним альбомом. Telegram допускает до 10 документов в альбоме, поэтому большее количество автоматически разбивается на группы по 10. Подпись применяется только к первому документу всей отправки.

Фото

tguser sendphoto photo.png --to me --caption "Скриншот"
tguser sendphoto p1.png p2.png p3.png --to work --caption "Галерея"

При двух и более файлах фото отправляются альбомом; подпись применяется к первому фото.

Видео

tguser sendvideo clip.mp4 --to me --caption "Запись"
tguser sendvideo a.mp4 b.mp4 --to work          # альбом

Аудио / музыка

tguser sendaudio track.mp3 --to me --caption "Трек"
tguser sendaudio one.mp3 two.mp3 --to me        # несколько треков

Голосовое сообщение

tguser sendvoice voice.ogg --to me --caption "Голосовое"

Видео-кружок

tguser sendvideonote note.mp4 --to me

Стикер

tguser sendsticker sticker.webp --to me

Контакт

Отправка контакта (имя + номер телефона):

# через флаги
tguser sendcontact --phone +77001234567 --first-name Иван --last-name Петров --to work

# позиционно: <phone> <first> [last] <target>
tguser sendcontact +77001234567 Иван Петров work
tguser sendcontact +77001234567 Иван work          # без фамилии
ФлагОписание
--phoneНомер телефона (обязателен)
--first-nameИмя (обязательно)
--last-nameФамилия (необязательно)
--toЦель

Результат

При успешной отправке выводится панель:

╭──────── ✓ Готово ────────╮
│ Отправлено в work        │
╰───────────────────────────╯

Если что-то пошло не так — см. 07. Решение проблем.