Альбомы, кнопки и подписи: какие сочетания Telegram не принимает
Проверенные живыми вызовами правила: когда можно кнопки, что бывает с альбомом и почему документ нельзя смешивать с фото.
Документация Bot API описывает методы, но почти не говорит о том, какие комбинации не работают. Ниже — то, что выясняется живыми вызовами.
Кнопки и альбом
Одно медиа с кнопками — можно. Альбом из нескольких фото с кнопками — формально запрос проходит, ответ приходит успешный, а кнопок в чате нет. Telegram молча их игнорирует.
Значит проверять должен ваш код: либо кнопки, либо альбом. Обходной путь один — отправить альбом отдельно, а текст с кнопками следом.
Однородность альбома
В один альбом собираются фото и видео вместе. Документы группируются только с документами, аудио — только с аудио. Смешать документ с фото нельзя: Telegram отвергает такой запрос целиком.
Голосовые и кружки
Голосовое сообщение и видеокружок всегда идут отдельным сообщением. Ни в альбом, ни к другому медиа их не добавить.
Подпись у альбома
Подпись показывается только у первого элемента, и её лимит — те же 1024 символа. Длинный текст под альбомом придётся отправлять вторым сообщением.
Практический вывод
Соберите правила один раз в проверку, которая срабатывает в момент прикрепления файла, а не при публикации. Человеку важно узнать «так нельзя» до того, как он написал пост, а не в момент, когда пост уже должен был выйти.
Мы так и сделали: недопустимое сочетание объясняется сразу, а длинный текст с альбомом уходит расширенным форматом. Смотрите возможности.