Пока все сомневаются, устанавливать ли мессенджер MAX себе на смартфон - я написал интеграцию для HomeAssistant, которая умеет отправлять сообщения в этот мессенджер.
Прошу всех подписаться на канал и поставить лайк. Вам не сложно, а мне приятно. И это помогает продвижению блога. Спасибо.
ВАЖНО
В данный момент регистрация на платформе разработчиков MAX доступна только индивидуальным предпринимателям и организациям. То есть юридическим лицам. Это ограничение самой платформы. К интеграции это отношения не имеет. Надеемся, что в ближайшем будущем эту процедуру упростят.
Предисловие
Многие пользователи столкнулись с проблемами в работе Telegram: блокировки, замедление и другие неполадки. Я уже давно пользуюсь мессенджером MAX и не испытываю подобных трудностей. Кроме того, мой сын учится в школе, и мне удобно следить за новостями класса прямо там, где они общаются, вместо того чтобы ждать, пока информацию передадут в другие мессенджеры.
HomeAssistant
Я давно использую HomeAssistant и постоянно стараюсь поддерживать свой умный дом в рабочем состоянии. Поэтому я решил создать интеграцию для MAX, чтобы все уведомления отправлялись туда.
Мне пришлось немного потрудиться над получением токенов. Возможно, в будущем этот процесс упростят. А сейчас вот инструкция.
Регистрация бота в MAX
Первым делом зарегистрируйтесь на платформе https://business.max.ru. Для создания бизнес-аккаунта понадобятся номер телефона и ИНН. Это немного отличается от регистрации в Телеграме, но процесс всё же достаточно прост. Надеюсь, в будущем создание ботов станет таким же удобным, как в Телеграме.
После прохождения верификации создайте бота. Войдите в свой кабинет на https://business.max.ru и найдите раздел "Чат-бот и мини-приложение". Заполните все поля (можно произвольно) и отправьте на верификацию. Хотя этот шаг кажется лишним, он необходим.
После успешной верификации бота на той же странице нажмите "Интеграции". Здесь вы получите API-ключ, который нужен для работы интеграции, как токен бота в Телеграме.
Получение UserID и ChatID
Для интеграции с Умным домом нам нужно получить идентификаторы чатов. Вы можете использовать групповую беседу (например, если вся ваша семья следит за оповещениями) или личный чат с ботом.
Чтобы получить идентификатор, напишите другому боту — @id222312277810_1_bot. Вы можете найти его в поиске, введя символ "@" перед идентификатором. Этот бот отправит вам ваш UserID — положительное число.
Для получения идентификатора группы перешлите любое сообщение из группы этому боту. Он сообщит вам ChatID — отрицательное число.
Интеграция
Теперь, когда у нас есть все данные, можно настроить интеграцию. Добавляем пользовательский репозиторий https://github.com/kai-zer-ru/max-notify-ha в HACS и устанавливаем его.
После установки и перезагрузки Home Assistant добавляем интеграцию. В первом окне требуется ввести API-ключ, который мы получили ранее, и выбрать формат текста: Markdown, HTML или Text. Все форматы работают корректно. Я предпочитаю Markdown, так как привык к нему.
Затем нужно добавить UserID/ChatID. После этого можно смело пользоваться интеграцией через встроенный сервис notify.send_message.
Свои сервисы отправки сообщений
Помимо стандартных сервисов отправки сообщений, в интеграции внедрены дополнительные внутренние сервисы, функционирующие независимо.
max_notify.send_message - отправка сообщения
Отправляет обычный текст адресату — ничего сложного. Ввожу данные и отправляю. Через этот способ у меня работают оповещения о запуске Home Assistant, открытии двери и другие уведомления, где нужен только текст.
max_notify.send_photo - отправка фотографий
Сервис позволяет отправлять фотографии и изображения. Их можно загрузить из файла или по ссылке. Качество не теряется, отправка происходит быстро и без задержек. Я использую его для передачи снимков с камеры наблюдения.
max_notify.send_document - отправка файла в виде документа
Этот сервис дает возможность загружать файлы разных форматов (PDF, DOCX и другие) и отправлять их через чат. Я пока им не пользуюсь.
max_notify.send_video - отправка видео
Последний на данный момент сервис — отправка видео. Он позволяет отправлять файлы и по URL. Если файл большой, сервис ожидает, пока серверы MAX загрузят и обработают его. Я также использую этот сервис для отправки видео с камеры.
Попробовал отключить уведомления, добавив параметр notify: false при отправке сообщений. По документации он должен отключать уведомления, но сейчас он не работает. Понаблюдаем, что будет дальше. Как только заработает, верну этот код.
Итоги
Вот такая получилась интеграция. Работает, а это главное. Буду поддерживать её дальше.
Всем спасибо за чтение, за интерес, комментарии. Буду благодарен за донаты 😊
Подписывайтесь на мой канал в Телеграме https://t.me/kai_zer_ru_ha и в MAX`е - https://max.ru/id251603503331_biz