Проверка доступности API Telegram в Hass.io
Д аже если вы не живёте в стране, которая активно борется с детищем Павла Дурова, но активно используете Telegram в своей инфраструктуре домашней автоматизации, всегда полезно узнать как можно раньше о том, что сервис по тем или иным причинам прекратил свою работу и ваш бот больше вам не бот.
Статья подразумевает, что вы уже сходили на поклон к BotFather, настроили бота Telegram и знаете, где взять API токен.
Создаём сенсор Telegram API
Создадим простой файл скрипта telegram_health.sh , который будет возвращать нужный нам результат:
Где XXXXX:YYYYY — это API token, полученный при создании бота. Файл можно проверить в любом окружении Linux, запустив команду
Если всё сделано правильно, скрипт должен нам ответить online .
Если ваш телеграм работает через Socks Proxy, в строку вызова curl выше можно добавить адрес этой прокси, например, так:
вариант с паролем:
Копируем скрипт в Hass.io
Теперь нам надо определиться, куда мы скопируем наш скрипт. Я предлагаю просто создать папку scripts внутри директории config и скопировать его туда. Это решение будет работать как с hassos, так и с hassio, установленным любым способом. Ещё один плюс — мы можем спокойно редактировать этот файл аналогично тому, как мы редактируем конфиги Hass.io
Добавляем в раздел sensors: файла configuration.yaml следующие строки:
Проверяем, что всё работает
Заходим в список наших сущностей (иконка <> в левом нижнем углу, набираем в фильтре telegram ) и видим наш замечательный сенсор в статусе online :
Проверить его работу достаточно просто — по умолчанию сенсор обновляется каждую минуту, достаточно отредактировать telegram_health.sh так, чтобы API нас отругал (например, заменить один символ в токене) и статус сенсора в течение минуты должен измениться на offline :
Создаём автоматизацию для уведомления
Использовать Telegram для уведомления о прекращении его работы не получится по понятным причинам, поэтому нам нужно выбрать другой канал нотификаций. Я решил выбрать html5 push нотификации, которые замечательно работают на платформах Windows и Андроид и точно не поддерживаются на iOS.
Квест по настройке, включающий в себя подтверждения владения доменом, от имени которого отправляются нотификации, пересказывать не буду, но оно того стоило. Теперь любое устройство, на котором открыт браузер Chrome или Firefox может выступать получателем таких сообщений, достаточно открыть веб-интерфейс Home Assistant и активировать переключатель push нотификаций:
На Android устройстве браузер может быть закрыт, уведомление всё равно придёт. Ходят слухи, что такого же поведения можно добиться в Google Chrome для Windows, установив хотя бы одно расширение, требующее прав для работы в фоновом режиме ( background ), но я не проверял, так как браузер у меня и так всегда открыт.
Создадим пару автоматизаций, которые будут отправлять на все устройства сообщение о недоступности Telegram и (sic!) удалять это сообщение, когда сервис окажется онлайн.
Здесь мы используем специальное свойство tag , позволяющее управлять конкретной нотификацией, которую мы отправили ранее. Например, закрыть её.
Вот так это выглядит на экране компьютера:
Сделать сенсор доступности API Telegram оказалось несложно. Нужно заметить, что он не отреагирует, если ваш бот вдруг испустит дух, но будет фиксировать только доступность API Telegram. Понятно, что у технологии html5 push есть свои ограничения, тут каждый может выбрать резервный канал нотификаций, подходящий ему. Остаётся только пожелать, чтобы данный сенсор нам никогда не понадобился.
Telegram api как понять что подключен
- Open with Desktop
- View raw
- Copy raw contents Copy raw contents
Copy raw contents
Copy raw contents
Telegram Bot API
Боты — специальные аккаунты в Telegram, созданные для того, чтобы автоматически обрабатывать и отправлять сообщения. Пользователи могут взаимодействовать с ботами при помощи сообщений, отправляемых через обычные или групповые чаты. Логика бота контролируется при помощи HTTPS запросов к API для ботов
НЕОФИЦИАЛЬНЫЙ вольный перевод о том, что из себя представляют боты https://tlgrm.ru/docs/bots
Список интересных групп/каналов, а также список чатов для программистов: https://github.com/goq/telegram-list
Заказать бота / стать исполнителем: https://t.me/tgram_jobs
Официальная актуальная английская документация по методам API: https://core.telegram.org/bots/api
(плохо с английским — идём за переводчиком http://translate.google.com)
Текстовые уроки «Пишем бота для Telegram на языке Python» с использованием библиотеки pyTelegramBotAPI:
- Текстовые уроки «Асинхронный Telegram бот на языке Python 3» с использованием библиотеки aiogram:
Видеоуроки «Разработка Телеграм бота на Python» с использованием библиотеки aiogram:
Список популярных библиотек:
-
— отлично подходит для начинающих, желающих понять основы работы с Bot API. Имеет подробную документацию (на английском языке) и обширное комьюнити. — продвинутая библиотека для создания высокопроизводительных ботов. Библиотека постоянно обновляется и имеет крутые фишки, например FSM, установку стандартного типа разметки и прочие мелочи, полезные при разработке. Комьюнити библиотеки на данный момент небольшое. — дополнение к библиотеке pyTelegramBotAPI, позволяющее быстро создавать inline-клавиатуры любой сложности, объединять несколько клавиатур в одну или генерировать их динамически. Имеет подробное описание с примерами.
-
— не самая простая библиотека, использует объектно-ориентированный подход
Q: Могу ли я посмотреть список всех пользователей канала?
A: Нет, если пользователей более 200
Q: Где захостить бота?
A: Бесплатно можно на Heroku, есть инструкция. Более удобный способ — купить VPS (Virtual Private Server). Это виртуальная машина, на которой можно запустить бота ровно так же, как и на своём компьтере.
Список некоторых хостинг-провайдеров:
Таблица сравнения минимальных тарифов
В 202X году каждый адекватный провайдер имеет бесплатный внешний ipv4 адрес и SSD диски вместо HDD. Бесплатные купоны и кредиты позволяют сильно сэкономить на сервере. Например, купоны из Github Student Pack позволяют получить $50 на DigitalOcean, а это почти год бесплатного сервера. Гугл в помощь!
Чтобы контрибьютить в таблицу, воспользуйтесь Сервисом, не мучайте себя!
Чуть более сложный, но интересный вариант — запустить бота на servlerless стеке. Например, в AWS каждый аккаут получает бесплатно NoSQL БД на 25 GB и 1M API-вызовов в месяц, чего вполне хватит для нескольких несложных ботов.
Q: Как сделать, чтобы бот ждал от пользователя следующее сообщение?
A: Используйте FSM (машины состояний). В некоторых библиотеках эта возможность уже встроена: пример aiogram
Q: Как хранить данные от пользователей?
A: Для долгосрочного хранения есть базы данных. Скорее всего, вашему небольшому проекту хватит мощностей SQLite. Если же проект подразумевает подключение к БД с разных ресурсов — взгляните на MySQL и PostgreSQL.
Особенности работы с Bot API
В этом разделе описаны различные хитрости и неочевидные способы работы с Bot API, которые помогут вам упростить разработку или восполнить какое-либо ограничение в API.
Отправка Фото с большой подписью
Ранее этот способ использовался из-за ограничения подписи к фото в 200 символов, на данный момент лимит составляет 1024 символа. Если вам этого всё ещё мало или хотите разместить фото под текстом, то вы можете воспользоваться предпросмотром ссылки. Делается это путем гиперссылки, где в качестве текста ссылки будет скрытый символ ( parse_mode=HTML ):
Бесплатный хостинг картинок
POST HTTP запрос http://telegra.ph/upload
Поддерживаемые типы медиафайлов: image/gif, image/jpeg, image/jpg, image/png, video/mp4, video/ogg, video/mpeg
Максимальный размер файла: 5 242 880 байт/5 МБайт
Примеры:
- Python
Убираем часики на inline-кнопках
Причина возникновения этих часиков — ожидание Телеграмом ответа от бота после нажатия пользователем на кнопку. Чтобы эти часики не зависали, после обработки нажатия нужно вызвать метод answerCallbackQuery
Лимиты Telegram Bot API
При отправке сообщений внутри определенного чата избегайте отправки более одного сообщения в секунду. Telegram может разрешить короткие всплески, которые превышают этот предел, но в итоге вы начнете получать 429 ошибку.
Если вы отправляете массовые уведомления нескольким пользователям, API не будет разрешать более 30 сообщений в секунду или около того. Рассмотрите возможность распространения уведомлений на большие интервалы в 8-12 часов для достижения наилучших результатов.
Ваш бот сможет редактировать посты других администраторов на каналах старше 48 часов только используя метод editMessageReplyMarkup, а также сможет их удалить, но другие методы изменения сообщений будут недоступны
Также обратите внимание, что ваш бот не сможет отправлять более 20 сообщений в минуту в одну группу.
Максимальный размер файла для скачивания 20 MB.
Максимальный размер файла для отправки 50 MB.
Максимальное число кнопок в строке — 8.
Максимальное число кнопок всего — 100.
- Максимальная длина колбека (callback_data) — 64 байта.
Telegram client API (он же MTProto, он же tgcli)
Клиентское API телеграма — это API позволяющее вам выполнять автоматизированные действия от лица клиента. Иными словами, всё, что может делать пользователь в телеграме, можно запрограммировать на tgcli (получить всю историю сообщений в группе, получить список всех пользователей группы, сделать поиск в группе по словам, взаимодействовать с ботами и т.д и т.п). Так как Telegram client api предполагает написание скриптов на tl (поверьте, вы не хотите на нём писать), то получили распространение обёртки над tgcli для разных языков.
Telegram api — как работать и для чего это нужно
Часто в интернете вы встречаете непонятные сочетания английских символов, о которых все говорят в положительном ключе. К примеру, как можно понять рассуждения о каком-то telegram bot api, да еще и понимать, что значит фраза: «Зачем его написали на c#, лучше бы на delphi?». Впрочем, данная статья решит ваши проблемы и поможет вам быть в теме: не углубляясь в программистские дебри, мы сейчас все объясним.
Что такое telegram api
Для начала мы поговорим о том, что вообще скрывается под этой аббревиатурой. Чтобы вам было понятнее, сначала мы углубимся в истоки истории программирования. Когда-то давным-давно код писался полностью с нуля. То есть, для того, чтобы программа просто показала пользователю какое-то слово, разработчик должен был вручную написать это на машинном языке, используя только 0 и 1.
Конечно, всегда так продолжаться не могло, поэтому однажды было решено автоматизировать весь этот процесс, создав библиотеки со встроенным набором функций. То есть, для вывода «Привет» разработчик должен был просто написать «cout << “Привет”», а подключенный им файл сам переводил это в последовательность нулей и единиц.
Осознав, что это довольно удобно, разработчики ввели понятие «API» ― встроенного интерфейса, позволяющего посылать операционной системе, компьютеру или еще чему-то команды на понятном для него языке. API автоматизировали создание игр или написание офисных программ, делая, к примеру, наложение текстуры на объект более простым.
Примером API может служить всем известный 1С
Для чего нужен телеграмм API
Теперь, когда вы поняли саму суть этого, перейдем к более конкретному примеру. А именно ― к интерфейсу ботов для телеграмм.