Приветствие новых подписчиков Telegram-канала

Бот отправляет сообщение в сам канал, но адресует его одному человеку — эфемерным сообщением Bot API. В ленте остальных подписчиков его нет. Это не личка: боту по-прежнему нельзя написать первым тому, кто его не запускал, поэтому приветствие живёт внутри канала.

Отправка привязана к моменту вступления: бот реагирует на переход «не был в чате → стал участником». Повышение до администратора и смена титула приветствием не считаются. Ботам оно не уходит.

На одного человека приходит не чаще раза в сутки — отписался и подписался снова в тот же день, второго приветствия не получит.

Работает только в каналах. Это наше решение, а не ограничение Telegram: мы сами отсекаем апдейт по типу чата, и в группе строка «Приветствие» в Студии не показывается. В Bot API право «Приветственные сообщения» описано без пометки о типе чата, в отличие от соседних прав.

Текст — до 2000 видимых символов: это наш потолок, Telegram в обычном сообщении даёт 4096. Кнопки-ссылки — до десяти штук, по две в ряду, до 64 символов на кнопку; это тоже наши пределы, а не телеграмовские. Адрес принимается только с http://, https:// или tg://.

Файл ровно один: фото, видео или GIF. Альбома не будет: у метода отправки альбома нет эфемерных параметров, слать его одному подписчику нечем. PDF, архив, аудио и голосовое приложить нельзя вовсе — выбор файла принимает только изображения и видео.

Вес считается по типу файла: фото до 10 МБ, видео и GIF до 50 МБ.

Фото или видео можно отправить файлом — тумблером в меню вложений. Кадр при этом перезаливается документом, а перезалить бот может файл до 20 МБ: фото проходит всегда, его собственный потолок ниже. Видео или GIF тяжелее 20 МБ в файловом режиме не уйдёт вовсе — и подписчик не получит приветствия целиком, а не только файла. Проверяется кнопкой «Отправить мне тест»: она отвечает ошибкой с причиной.

Файл меняет и текст. Он едет подписью под медиа, а подпись у Telegram короче — 1024 символа, и перебор не даёт сохранить приветствие. Блочная разметка в подписи тоже не живёт: заголовки, списки и таблицы придут обычными строками. Экран предупреждает об этом заранее.

Обращение по имени делается переменными: {first_name}, {last_name}, {full_name}, {username} и {channel} — название канала. Фамилии или юзернейма у подписчика может не быть; пустая подстановка убирается вместе с повисшей запятой и лишним пробелом, «Привет, !» не получится.

Чтобы отправить приветствие, боту нужно админ-право «Приветственные сообщения». При подключении канала PostBot его не запрашивает — ни через выбор канала в боте, ни через ссылку на добавление в администраторы.

Включают его руками: канал в Telegram → «Управление» → «Администраторы» → выбрать бота → включить право.

Экран приветствия проверяет право живым запросом к Telegram. Но говорит он только об одном исходе: если права нет — красная плашка с шагами, а при сохранении включённого приветствия экран ещё и переспрашивает.

Сохранить всё равно можно, только подписчикам такое приветствие не уйдёт. Если проверить право не удалось — бота нет в канале, Telegram не ответил, — экран молчит намеренно. Молчание не значит, что право есть.

Кнопка «Отправить мне тест» присылает то же сообщение вам в личку от бота — обычным, а не эфемерным: оно остаётся в чате, и его можно перечитать. Чаще раза в три секунды кнопка не сработает.

Приветствие бесплатное: тарифного гейта в коде функции нет, на бесплатном тарифе она работает так же.

Править его может владелец канала или участник команды с правом на настройки канала. На бесплатном тарифе активных участников команды нет вовсе — ноль: приветствие ведёт владелец сам, команда начинается с Premium, до двадцати человек.

Второй соседний лимит — каналы: два на бесплатном тарифе, пятьдесят на Premium.

С Telegram 13 владелец канала собирает приветственный пакет прямо в клиенте — по словам анонса, ботов для этого не нужно. Что в этом пакете есть, мы знаем только из того же анонса: несколько сообщений, медиа, форматирование.

Чем он располагает сверх этого — есть ли там кнопки, подстановка имени, — мы не проверяли: в анонсе об этом ни слова, а прочитать пакет через Bot API нельзя.

Наше приветствие обращается к подписчику по имени через переменные, несёт кнопки-ссылки, умеет тест-отправку себе и правится там же, где остальные настройки канала.

Прочитать или изменить настроенный владельцем пакет PostBot не может: в Bot API нет ни метода, ни поля для него. Что увидит подписчик, если включены оба приветствия, мы не проверяли — в нашем исследовании это открытый вопрос без источника.