Обработчики вложений
Что это такое
Вложения — это любые медиафайлы и контент, которые пользователи отправляют в Telegram помимо обычного текста: фотографии, видео, аудио, стикеры, документы, геолокации и многое другое.
Обработчики вложений позволяют боту реагировать на конкретные типы файлов и извлекать из них данные (например, file_id для повторной отправки).
Важно:
В отличие от системных сообщений, для обработки вложений боту не нужны права администратора (за исключением особых случаев, например, отслеживания сторис в каналах).
Доступные типы вложений
Ниже представлен полный список типов вложений, которые можно отслеживать в EnotPro.
| Тип | Описание | Пример использования |
|---|---|---|
| Photo | Фотография (обычное фото, может быть в нескольких размерах) | Получение фото от пользователя, ресайз, пересылка |
| Video | Видеофайл | Получение видео, извлечение длительности и размера |
| Audio | Аудиофайл | (музыка, подкаст) Получение аудио, извлечение исполнителя и названия |
| Voice | Голосовое сообщение | Распознавание речи, пересылка |
| VideoNote | Видео-сообщение («кружок») | Получение видеосообщений |
| Story | История (сторис) | Отслеживание публикации сторис в канале |
| Sticker | Стикер | Получение стикера, его file_id для ответа |
| Document | Документ, файл (PDF, ZIP, XLS и др.) | Приём файлов, проверка расширения |
| Animation | GIF-анимация | Получение GIF, повторная отправка |
| Contact | Контакт (визитная карточка) | Получение номера телефона и имени |
| Dice | Игральная кость (рандом) | Обработка эмодзи-рандома: 🎲, 🎯, 🎳, ⚽, 🏀 |
| Game | Облачная игра | Обработка игровых сообщений (HTML5-игры) |
| Location | Геолокация (точка на карте) | Получение координат |
| Venue | Место, заведение (название + адрес) | Получение информации о месте |