В разделе рассмотрены примеры сниппетов, для работы с файлами, медиа и URL-адресами при создании Telegram бота с помощью пакета python-telegram-bot .
Внимание! Пакеты python-telegram-bot версии 13.x будут придерживаться многопоточной парадигмы программирования (*на данный момент актуальна версия 13.15). Пакеты версий 20.x и новее предоставляют чистый асинхронный Python интерфейс для Telegram Bot API. Дополнительно смотрите основные изменения в пакете python-telegram-bot версии 20.x.
Здесь рассматривается методы экземпляра bot = telegram.Bot() . Если при создании бота используется пакет расширения telegram.ext , то методы объекта bot будут доступны через:
- updater.bot — это экземпляр telegram.Bot , связанный с экземпляром Updater , который присылает и отправляет все сообщения;
- в функции обратного вызова через контекст context.bot — это telegram.Bot связанный с контекстом обработанного сообщения.
from telegram.ext import Updater, CommandHandler TOKEN = ‘Замените строку на Ваш token’ updater = Updater(token=TOKEN) dispatcher = updater.dispatcher # экземпляр `telegram.Bot`, связанный с экземпляром `Updater` updater.bot.send_photo(. ) # методы `telegram.Bot` доступны через `context` def call_back(update, context): . # `telegram.Bot` связанный с контекстом # обработанного сообщения context.bot.send_photo(. ) . dispatcher.add_handler(CommandHandler(«you_command», call_back))
Публикация файлов, media и URL-адресов в Telegram.
Если нужно отправить файл, например, отправить фото, то для этого есть три метода:
Используйте телеграмм как бесплатное облачное хранилище
- Загрузить файл в Telegram.
- Отправить HTTP-ссылку, ведущую к файлу
- Отправить file_id уже отправленного файла.
Обратите внимание, что не каждый метод поддерживается везде (например, для thumbnails нельзя передать file_id ).
Смотрим, как можно отправить документ.
- Загрузка файла в Telegram:
bot.send_document(chat_id=chat_id, document=open(‘tests/test.png’, ‘rb’))
bot.send_document(chat_id=chat_id, document=’https://site.ru/static/test.gif’))
bot.send_document(chat_id=chat_id, document=file_id))
- У каждого бота есть свои собственные идентификаторы файлов, т.е. вы не можете использовать идентификатор файла от другого бота для отправки фотографии
- Как получить fileid фотографии, которую вы отправили? Прочтите его из возвращаемого значения bot.senddocument (или любого другого объекта Message, который вы получите):
message = bot.send_document(. ) file_id = message.document.file_id
Примечание. Метод bot.send_document используется для отправки файлов любого типа. В настоящее время боты могут отправлять файлы любого типа размером до 50 МБ, это ограничение может быть изменено в будущем. Аргументом document может быть либо file_id , либо URL-адрес, либо файл с диска открытый как open(file_name, ‘rb’) . Отправка по URL в настоящее время работает только с файлами GIF, PDF и ZIP.
Безлимитное облачное хранилище, абсолютно бесплатно!
Это почти так же работает для всех других методов send_media_type , таких как bot.send_photo() , bot.send_video() и т. д.
Далее рассматриваются другие распространенные примеры кода. Обратите внимание на то, что подход к публикации файлов почти одинаков, НО методы экземпляра bot разные!
Опубликовать файл изображения с диска в Telegram.
bot.send_photo(chat_id=chat_id, photo=open(‘tests/test.png’, ‘rb’))
Опубликовать фото с URL-адреса в Telegram.
bot.send_photo(chat_id=chat_id, photo=’https://telegram.org/img/t_logo.png’)
Опубликовать голосовой файл с диска в Telegram.
bot.send_voice(chat_id=chat_id, voice=open(‘tests/telegram.ogg’, ‘rb’))
Опубликовать аудио файл с диска в Telegram.
bot.send_audio(chat_id=chat_id, audio=open(‘tests/test.mp3’, ‘rb’))
Опубликовать документ или архив с диска в Telegram.
bot.send_document(chat_id=chat_id, document=open(‘tests/test.zip’, ‘rb’))
Опубликовать гифку в Telegram.
Используйте этот метод для отправки файлов анимации (видео в формате GIF или H.264/MPEG-4 AVC без звука). В настоящее время боты могут отправлять файлы анимации размером до 50 МБ, это ограничение может быть изменено в будущем.
bot.send_animation(chat_id=chat_id, document=open(‘tests/animation.gif’, ‘rb’))
Опубликовать медиа-группу из фото, расположенных в URL-адресах:
Используйте этот метод для отправки группы фотографий или видео в виде альбома.
from telegram import InputMediaPhoto list_of_urls = [ ‘https://example.org/commons/foto1.jpg’, ‘https://example.org/commons/foto2.jpg’, ‘https://example.org/commons/foto3.jpg’ ] # список мультимедиа media_group = [] for number, url in enumerate(list_of_urls): media_group.append(InputMediaPhoto(media=url, caption=»Фотография №» + number)) bot.send_media_group(chat_id=chat_id, media=media_group)
Примечание Элементы в списке мультимедиа media_group обязательно должны быть экземплярами InputMediaAudio , InputMediaDocument , InputMediaPhoto или InputMediaVideo .
Редактирование файла, отправленного в Telegram.
Если файл отправлен, то можно его отредактировать. Это работает аналогично send_media_group , т. е. медиаданные должны быть заключены в объект InputMedia . Опять же, с документом в качестве примера:
bot.edit_message_media(chat_id=chat_id, message_id=message_id, media=InputMediaDocument(media=open(‘tests/test.png’), . ))
Ознакомьтесь с ограничениями на редактирование мультимедиа в документах send_media_group .
Выложить изображение прочитанное в оперативную память:
В этом примере изображение является объектом изображения модуля Pillow , но оно работает одинаково со всеми типами мультимедиа.
from io import BytesIO bio = BytesIO() bio.name = ‘image.jpeg’ image.save(bio, ‘JPEG’) bio.seek(0) bot.send_photo(chat_id, photo=bio)
Получить изображение с размерами, максимально приближенными к желаемому размеру:
Где photos — это список объектов PhotoSize , а desired_size — кортеж, содержащий нужный размер.
def get_closest(photos, desired_size): def diff(p): return p.width — desired_size[0], p.height — desired_size[1] def norm(t): return abs(t[0] + t[1] * 1j) return min(photos, key=lambda p: norm(diff(p)))
Загрузка файлов из Telegram сообщений.
Примечание. При загрузке фотографий имейте в виду, что update.message.photo — это массив фотографий разных размеров (упорядоченный от самого малого к большому).
Используйте update.message.photo[-1] , чтобы получить самый большой размер.
file_id = message.voice.file_id newFile = bot.get_file(file_id) newFile.download(‘voice.ogg’)
Кроме того, приведенный выше фрагмент можно сократить, используя встроенные ссылки:
newFile = message.effective_attachment.get_file() newFile.download(‘file_name’)
message.efficient_attachment автоматически содержит любое мультимедийное вложение, которое есть в сообщении — в случае фотографии снова придется использовать, например: message.efficient_attachment[-1].get_file() .
Источник: docs-python.ru
25 полезных ботов для Telegram на все случаи жизни
Trailcam.ru — облачный сервис для фотоловушек
Фотоловушки. Незаменимые помощники в наблюдении за природой, в охране и охоте. Вот уже десяток лет они помогают нам в повседневной жизни. Сначала мы использовали простые камеры, потом появились фотоловушки с поддержкой MMS, а около 7 лет назад в обиход вошли камеры с передачей данных на e-mail.
Много времени прошло с тех пор, но надёжные «старички» по прежнему в строю, исправно выполняют свою работу. В дополнение и на смену приходят новые современные камеры. Парк приборов всё увеличивается, а их обслуживание всё более усложняется. Современные e-mail сервисы, через которые работают фотоловушки — вообще отдельная история.
В попытках защиты пользователей и борьбы со спамом их правила стали меняться так часто, а «барьеры» усложняться, что на отслеживание изменений приходится тратить всё больше и больше времени. Благодаря этим усложнениям камеры неожиданно перестают отправлять сообщения, а старые модели — вовсе отказываются работать. Как быть? Как обеспечить надёжную работу камеры в постоянно меняющихся условиях? Решение есть — специализированный сервис, предназначенный именно для фотоловушек.
В 2020 году мы разработали и запустили в работу наш новый проект. За год, прошедший с момента старта, в процессе не публичного тестирования и после череды бесконечных проверок, отладок у нас получился удобный и понятный сервис, которым уже пользуется первая тысяча пользователей со всей страны (на момент написания статьи). Сейчас мы готовы сообщить публично и пригласить всех пользователей фотоловушек попробовать наш облачный сервис. Встречайте:
Что такое trailcam? В первую очередь — это устоявшийся термин и самая известная в мире аббревиатура, объединяющая всё разнообразие устройств, которые мы знаем как «фотоловушки». И это идеальное название для сервиса, который предназначен для таких приборов. Для сервиса, который не имеет границ и ограничений.
Что может трейлкам.ру?
- Принимать фото и видео с любых фотоловушек, независимо от года изготовления и производителя;
- Доставлять полученные материалы непосредственно в ваш мессенджер и ваш e-mail на любом почтовом сервисе;
- Динамически менять получателя простым изменением настроек в облачном сервисе;
- Работать с фотоловушками, не поддерживающими шифрование;
- На лету генерировать настройки для вашей камеры — ваш основной почтовый ящик никогда не будет скомпроментирован!
- Хранить материалы в защищённом облачном хранилище, доступном с любых устройств;
Главное условие — наличие GSM модуля в самой фотоловушке и поддержка протокола SMTP (отправки фотографий через Интернет).
Как подключиться к облачному сервису trailcam.ru?
Посмотрите наш видео-обзор облачного сервиса Trailcam.ru:
Шаг 2: Знакомимся с доступными командами и регистрируемся
Для того, чтобы открыть подсказку по доступным командам, введите команду /help или нажмите на /help в сообщении.
Если вы подключились к сервису впервые, то вам потребуется создать в нём свою учётную запись. Сделать это можно путём отправки боту команды /add. Именно эта команда запустит процесс создания новой учетной записи для вашей фотоловушки.
Теперь вам необходимо ввести название вашей учетной записи (называйте её как пожелаете, в будущем это название можно будет изменить) и адрес вашей действующей электронной почты. В следующем сообщении бот покажет вам данные вашей учетной записи и предложит подтвердить электронную почту с помощью проверочного кода. Чтобы проверочный код был выслан на вашу почту, нажмите кнопку «отправить». После введения полученного кода ваша запись будет считаться подтвержденной и вы получите доступ к ее настройкам.
Шаг 3: Реквизиты доступа и настройка фотоловушки
Для того, чтобы получить реквизиты доступа, нажмите на соответствующую кнопку. Обратите внимание на то, что сервис trailcam.ru не хранит пароли пользователей и в случае утери пароля инженеры сервиса не смогут напомнить вам старый пароль, который вы забыли или потеряли. Вам придётся создать новый пароль и заново перенастроить фотоловушку. Рекомендуем записать или сохранить пароль во избежание возможных неприятных ситуаций.
После получения реквизитов доступа можно переходить непосредственно к настройке вашей камеры. Самый простой способ настройки — с использованием персонального компьютера и специального приложения, которое входило в комплект поставки вашей фотоловушки. Также ничто не мешает сделать настройки в меню камеры, если сама фотоловушка конечно-же позволяет это сделать. Ниже приведён пример окна настройки одной из самых распространённых китайских фотоловушек Suntek и их программы настройки — MMS Config для камер с поддежкой 2G/3G. В вашем случае это может быть другая программа, от другого производителя.
Запустите приложение и переходите к настройкам параметров SMTP. Настройки MMS нам не нужны, так как не будут использоваться вовсе. Тем не менее, если вы хотите настроить и эти параметры, то в этой статье мы как раз об этом подробно рассказываем.
Установите следующие значения:
| Поле SMTP SETTINGS | |
| SMTP | ON |
| SMTP MODE | Manual |
| Country | Other |
| Operator | Other |
| Поле GPRS Settings (вводимая информация зависит от вашего оператора) | ||||
| Мегафон | Билайн | МТС | Теле2 | |
| APN | internet | internet.beeline.ru | internet.mts.ru | internet.tele2.ru |
| Account | gdata | beeline | mts | оставить пустым |
| Password | gdata | beeline | mts | оставить пустым |
На данном этапе пароль и почта указываются те, которые вы получили в реквизитах доступа (шаг 3). При этом, адрес почты отправителя (в блоке настроек Server Setting) и почты получателя (в блоке настроек Email Settings) должны совпадать.
После того, как все данные внесены, необходимо подключить фотоловушку или карту памяти из неё к компьютеру (она определится системой как usb-накопитель) и сохранить файл с настройками на вашу фотоловушку нажатием кнопки «Save». Если на съёмном носителе вы увидели вновь созданный файл Parameter.dat, значит вы все сделали правильно. Теперь камеру можно отключить от компьютера, обновить настройки камеры и перейти к ее использованию.
Шаг 4: Настройка хранилища и доступ по ссылке
Теперь хранилище подключено и вы можете войти в него. Сделать это можно на сайте Trailcam.ru или через бота по сгенерированной ссылке. Для этого нажмите кнопку «Войти в хранилище», а затем «Открыть ссылку».
Шаг 5: Настройка уведомлений
Для настройки уведомлений введите команду /list и нажмите кнопку «Уведомления», а затем выберите наиболее подходящий для вас тип уведомлений.
Поздравлявем! Вы закончили настройку доступа к сервису Trailcam.ru и теперь сможете просматривать фотографии и видео с вашей фотоловушки, а так же изменять настройки ее параметров в любое время и в любом месте.
Шаг 6: Изменение настроек учетной записи
Вызовите меню настроек с помощью команды /list, а затем нажмите на кнопку «Настройки». В этом разделе вы можете изменить название вашей учетной записи, вид сообщений, присылаемых фотоловушкой и поменять адрес электронной почты, на которую будут приходить фотографии и видео.
Для измнения названия учетной записи нажмите на кнопку «Переименовать», а затем введите новое название учетной записи
Для того, чтобы изменить вид сообщений, которые будут приходить на почту, нажмите на кнопку «Вид сообщений», а затем выберите один из предложенных вариантов. С этого момента сообщения на почту будут приходить в измененном формате.
Trailcam bot позволяет изменить электронный адрес получателя без физического контакта с ловушкой. Для этого необходимо попасть в меню настроек профиля, после чего нажать кнопку «Получатель» и ввести новый адрес электронной почты. Все снимки и видео, записанные с этого момента будут приходить на этот адрес электронной почты.
Если после прочтения интрукции у вас все еще остались вопросы — воспользуйтесь помощью специалистов сервиса — напишите им в техподдержку с помощью отправки команды /support в телеграм-боте.
Источник: fotolovushki.ru