Habab Home / Инструкции

Подключите Telegram к Habab Home

Создайте собственного бота, добавьте его в Habab Home и привяжите личный чат. Доступ домашней группы можно настроить отдельно.

Пошаговая инструкция для домашней установки Habab Home. Публичное демо показывает только виртуальную панель и не подключает ботов.

Шаг 1

Создайте бота в Telegram

Найдите @BotFather и проверьте точное имя аккаунта. Отправьте команду /newbot. Сначала задайте имя, которое будет видно в Telegram, затем username — короткое имя для поиска и ссылки. В нём должно быть 5–32 символа: латинские буквы, цифры или подчёркивания; username должен оканчиваться на bot. Если он занят, придумайте другой.

В ответ BotFather пришлёт токен — секретный ключ, который позволяет управлять ботом.

Что должно получитьсяСкопируйте токен для следующего шага. Не пересылайте его и не публикуйте; если он станет известен другим, отзовите его через BotFather и замените в Habab.

Учебный HTML-рендер диалога с BotFather: команда /newbot, ввод имени и username, токен закрыт плашкой — Учебный HTML-рендер · Создайте бота в Telegram

Шаг 2

Подключите токен в Habab Home

Откройте раздел Telegram в своей домашней установке Habab Home. Вставьте токен BotFather в поле «Токен бота» и нажмите «Подключить бота». Habab проверит токен через Telegram и сохранит его в настройках Home Assistant.

Не вставляйте токен в публичное демо: его форма не запускает настоящего бота.

Что должно получитьсяПосле успешной проверки появятся шаги привязки личного чата и домашней группы.

Учебный HTML-рендер панели Habab Home: поле «Токен бота» с замаскированным учебным значением и кнопка «Подключить бота» — Учебный HTML-рендер · Подключите токен в Habab Home

Шаг 3

Привяжите личный чат владельца

Нажмите «Получить ссылку для привязки», затем «Открыть Telegram и привязать аккаунт». Откроется чат с вашим ботом. Нажмите «Запустить» — так Habab свяжет ваш личный чат с установкой.

Одноразовая ссылка действует 10 минут. Не отправляйте её другим людям.

Что должно получитьсяСтатус сменится на «Бот и личный чат владельца подключены».

Учебный HTML-рендер: кнопка Habab для получения одноразовой ссылки и личный чат Telegram с кнопкой «Запустить» — Учебный HTML-рендер · Привяжите личный чат владельца

Шаг 4 · по желанию

При желании подключите домашнюю группу

Создайте группу, например «Моя квартира» или «Моя дача», и добавьте туда только тех людей, которым доверяете. В Habab нажмите «Создать ссылку для группы», откройте её и выберите нужную группу в Telegram.

Привязка группы необязательна: личный чат владельца работает отдельно.

Что должно получитьсяВладелец и участники с доступом могут писать боту лично. Участники привязанной группы могут писать и прямо в ней; ответы видны всем участникам группы.

Учебный HTML-рендер Habab Home и Telegram: кнопка создания ссылки для группы и экран выбора домашней группы — Учебный HTML-рендер · При желании подключите домашнюю группу

Шаг 5 · по желанию

Назначьте бота администратором группы

Откройте настройки группы Telegram, найдите бота в участниках и назначьте его администратором, чтобы Habab мог проверять состав группы. Затем дождитесь проверки статуса в разделе Telegram.

Если Habab сообщает, что права не подтверждены, проверьте статус бота и повторите проверку.

Что должно получитьсяПосле проверки появится состояние «Домашняя группа подключена».

Учебный HTML-рендер настроек группы Telegram с ролью администратора для бота и статусом проверки Habab — Учебный HTML-рендер · Назначьте бота администратором группы

Шаг 6

Проверьте личный чат и группу

Каждый участник сначала открывает личный чат с ботом и нажимает «Запустить». После этого он может писать боту и лично, и прямо в привязанной группе. Отправьте короткий безопасный запрос в каждом чате.

Для пароля, кода подтверждения или защищённой формы настройки откройте веб-интерфейс Habab Home. Ответы в группе видны всем её участникам.

Что должно получитьсяПроверьте ответ в обоих чатах. Этот шаг подтверждает только ответы бота и не проверяет управление физическими устройствами.

Учебный HTML-рендер личного чата с ботом: кнопка «Запустить», пример короткого запроса и область ответа без выдуманного результата — Учебный HTML-рендер · Проверьте личный чат и группу

Если не получается

Username уже занят: Выберите другой username. Username должен оканчиваться на bot.
Не привязывается личный чат: Откройте свежую ссылку и нажмите «Запустить». Одноразовая ссылка живёт 10 минут.
Токен неверный или отозван: Проверьте токен в BotFather. Если выпустили новый, замените сохранённый токен в разделе Telegram.
Участник не получает ответ: Проверьте, что участник нажал «Запустить» в личном чате и сейчас состоит в привязанной группе. Он может писать боту лично и прямо в группе; групповой ответ увидят все её участники.
Группа не подключается: Проверьте, что выбрана группа, а не канал, назначьте бота администратором и запросите статус снова.

Если меняли или отзывали токен в BotFather, обновите его в Habab Home. Одноразовые ссылки и токены нельзя пересылать в общий чат или публиковать.