Использование Telegram бота с Raspberry Pi для передачи файлов и сообщений

Raspberry Pi является хорошим инструментом для реализации многих интересных проектов в электронике благодаря наличию мощного процессора на архитектуре ARM и Linux-подобной операционной системе. В этом проекте мы рассмотрим использование Telegram бота для обмена данными (файлы/фото/видео/аудио и др.) между платой Raspberry Pi и мобильным телефоном (смартфоном).

Внешний вид проекта использования Telegram бота вместе с платой Raspberry Pi

Наверняка вы уже знаете что Telegram – это один из самых популярных мессенджеров в настоящее время, доступный в настоящее время для операционных систем Android и Windows, а также для смартфонов Iphone. Он предоставляет продвинутые возможности чата и обмена файлами/сообщениями, по своим характеристикам и скорости работы он превосходит другой популярный мессенджер современности – Whatsapp.

Одной из "продвинутых" возможностей приложения Telegram является то, что оно поддерживает ботов. Это означает, что возможностями данного приложения могут пользоваться не только люди, но и "машины". В нашем случае в роли "машины" будет выступать плата Raspberry Pi. Как только вы обучите Raspberry Pi выполнять роль Telegram бота, она сможет "сидеть в чате" с обычным человеком и "расшаривать" фото, картинки, документы и аудио файлы. Также такого бота можно натренировать чтобы он был вашим персональным помощником (Personal assistant).

Демонстрация совместной работы Telegram бота и платы Raspberry Pi

Необходимые компоненты

  1. Плата Raspberry Pi (купить на AliExpress), подключенная к сети интернет.
  2. Запущенное на смартфоне приложение Telegram.

Настройка Raspberry Pi в качестве Telegram бота

Для того, чтобы ваша плата Raspberry Pi могла исполнять роль Telegram бота, выполните следующую последовательность шагов.

Шаг 1 . Установка приложения Telegram на ваш смартфон

Приложение Telegram доступно для платформ на основе операционных систем Android, IOS и даже для Windows. Скачайте его на свое устройство (смартфон), установите и пройдите простую процедуру регистрации. После этого оно будет готово к работе.

Шаг 2. Создание нового бота Telegram

В правом верхнем углу главного экрана приложения Telegram есть иконка поиска, нажмите ее и выполните поиск “botfather” ("отец ботов"). Botfather – это бот, который поможет создать вам нового бота. Нажмите в нем start и затем выберите newbot как показано на рисунке ниже. После этого Botfather попросит вас ввести параметры нового бота: имя бота и пользовательское имя бота. Заполните эти детали и запомните введенное имя пользователя (username) – оно нам понадобится в дальнейшем.

Создание нового бота Telegram с помощью BotfatherШаг 3. Получение вашего токена (token) доступа (маркера доступа)

Мы назвали бота circuitdigest, а в качестве его пользовательского имени (username) мы использовали circuitdigestBot. После этого приложение botfather выдаст вам маркер доступа (Token for access) – это своеобразный пароль для бота, другие люди могут использовать вашего бота если они знают его ключ доступа (token key). Поэтому храните этот ключ в надежном месте и не показывайте его никому. Как только вы получили этот ключ доступа, можно переходить к работе на Raspberry Pi.

Получение токена доступа к боту Telegram

Шаг 4. Установка приложения Telegram на Raspberry Pi

Использовать Telegram бота в Raspberry Pi можно с помощью пакета на python под названием Telepot. Необходимо установить данный пакет в Raspberry Pi с помощью соответствующих команд в Lx терминале:

После того как Telepot будет импортирован в Raspberry Pi, вы можете использовать возможности этого пакета в своей программе на python чтобы взаимодействовать с вашим Telegram ботом.

Шаг 5. Написание программы для платы Raspberry Pi

Созданный вами в предыдущих шагах бот пока что подобен "ребенку" – он не сможет делать что то полезное пока вы не научите его этому. Обучить бота можно с помощью платы Raspberry Pi и скрипта на Python.

В этом проекте мы запрограммируем бота чтобы он мог выполнять основные операции: передача сообщения, фото, аудио и документов. То есть когда вы будете давать ему конкретную команду он будет выполнять определенное действие. Список доступных команд для нашего бота представлен в следующей таблице:

Команда от Telegram Действие платы Raspberry Pi
/hi Передает в ответ строку “Hi! CircuitDigest”
/time Передает в ответ текущее время
/logo Передает в ответ изображение
/file Передает в ответ файл
/audio Передает в ответ аудио файл

Полный код программы для бота приведен в конце статьи, здесь же мы кратко рассмотрим его основные фрагменты.

Первым делом в программу необходимо импортировать (подключить) все необходимые библиотеки, на этом этапе нам обязательно нужно подключить библиотеку telepot – без нее мы не сможем управлять нашим Telegram ботом. Также мы будем использовать библиотеки time и timedate для считывания текущего времени в Raspberry Pi. После этого мы создадим объект, в котором будет храниться считанное значение времени.

Далее нам необходимо создать функцию, которая будет в зависимости от поступающих команд выполнять соответствующие действия. Команды будут поступать от приложения Telegram на смартфоне. Эту функцию назовем именем action. Внутри этой функции бот будет "оживать". Наш бот не сможет поддерживать разговор с нами, он сможет только отвечать если мы что-нибудь у него спросим. То есть каждый раз когда мы будем что то спрашивать у бота, будет формировать идентификатор чата (chat id). Данный идентификатор чата подобен адресу, только используя данный идентификатор бот сможет нам ответить. То есть первым делом в этой функции необходимо считать этот идентификатор чата (chat id) и сам текст сообщения (команды). Мы будем выводить текст принятого сообщения на экран дисплея в целях отладки.

Далее внутри функции мы будем сравнивать текст принятого сообщения (команды) с заранее определенными командами и на основании результата этого сравнения выполнять соответствующие команды. Если мы примем сообщение (команду) “/hi”, то мы будем отвечать на него “Hi! CircuitDigest”.

Если мы примем сообщение (команду) “/time”, то в ответ на него мы будем передавать текущее время. Текущее время и дата хранятся у нас в объекте now, нам здесь просто необходимо выделить (вычленить) из этого объекта значения часов и минут с помощью функции str и затем сложить их.

Если мы примем сообщение (команду) “/logo”, то в ответ на него мы считаем изображение с определенного url адреса и передадим его в ответ на принятое сообщение. Вместо считывания изображения с url адреса его также можно считывать с жесткого диска вашего компьютера. В данном случае мы использовали изображение, являющееся логотипом сайта CircuitDigest.com.

Если мы примем сообщение (команду) “/file”, то в ответ на него мы будем передавать файл с именем Aisha.py с жесткого диска нашего компьютера. Вы можете использовать любой другой файл, внеся соответствующие изменения в данный фрагмент программы.

Если мы примем сообщение (команду) “/audio”, то в ответ на него мы будем передавать mp3 файл с жесткого диска нашего компьютера. Мы использовали файл с именем test.mp3, однако вы можете использовать файл с любым другим именем, внеся соответствующие изменения в программу.

И, наконец, мы подошли к самому важному фрагменту нашей программы, в котором мы должны предоставить доступ нашему Telegram боту к скрипту на Python. Имя у нашего бота – telegram_bot, к нему мы будем обращаться с помощью маркера/токена доступа (token address), который нам был выдан ботом botfather на шаге 3. В команде, которая приведена ниже, мы в целях безопасности нашего бота удалили из его маркера/токена доступа несколько последних цифр. Также мы будем использовать команду print чтобы отображать детали взаимодействия с ботом на экране дисплея.

Шаг 6. Исполнение программы на Raspberry Pi

Полный текст программы приведен в конце статьи. Не забудьте в тексте программы заменить токен (маркер доступа) на свой. После этого запустите код программы на выполнение и вы должны увидеть параметры (детали) вашего бота в окне как на приведенном ниже рисунке. Пользовательское имя (user name) нашего бота – circuitdigestBot. Если вы видите в этом окне имя вашего бота – значит все в порядке.

Исполнение программы с ботом Telegram на Raspberry Pi

Если вы видите надпись “up and running” – это значит что ваш бот готов к работе и способен отвечать на ваши сообщения/команды.

Шаг 7. Тестирование работы проекта

Теперь, когда все уже готово, нам осталось лишь протестировать работы бота. В приложении запустите поиск бота по имени, в нашем случае это будет “circuitdigestBot”. Поиск можно также запускать по пользовательскому имени бота.

После того как вы нашли своего бота, нажмите в нем на start и введите в нем одну из описанных ранее команд: /hi, /time, /file, /logo или /audio. На каждую из этих команд бот должен дать соответствующий ответ.

Примечание: у вас могут возникнуть проблемы с командами /audio и /file если в тексте программы вы не изменили каталог и имя файла для этих типов файлов на те, которые есть в вашей Raspberry Pi.

Передача команд плате с помощью бота Telegram (часть 1) Передача команд плате с помощью бота Telegram (часть 2)

Более подробно работу проекта можно посмотреть на видео, приведенном в конце статьи.

Тестирование работы проекта

Исходный код программы на Python

Видео, демонстрирующее работу проекта

Источник статьи

(Проголосуй первым!)
Загрузка...
82 просмотров


Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *