diff --git a/README.md b/README.md index 5ab19e9..67a7220 100644 --- a/README.md +++ b/README.md @@ -126,6 +126,7 @@ In Russian ### Помощь - [Веб-интерфейс](ru/help-webui.md) +- [Настройка отправки в Telegram](/ru/telegram_help_ru.md) ### Камеры - [Switcam HS-303](ru/hardware-hs303.md) diff --git a/en/howto-streaming-telegram.md b/en/howto-streaming-telegram.md index 57273db..003a2ad 100644 --- a/en/howto-streaming-telegram.md +++ b/en/howto-streaming-telegram.md @@ -13,6 +13,10 @@ Copy Server URL and Stream key from Settings. Open `/etc/majestic.yaml` on camera and add the URL and the key into `outgoing` section of the config. +**Note:** Dont forget add `-` sign before paramethers! + +**Note:** `outgoing` section may affect another section addition. Remember it! +   diff --git a/ru/telegram_help_ru.md b/ru/telegram_help_ru.md new file mode 100644 index 0000000..6f95742 --- /dev/null +++ b/ru/telegram_help_ru.md @@ -0,0 +1,49 @@ +## Настройка ботов и каналов в телеграм для работы с OpenIPC + +Для того, чтобы использовать телеграм в качестве бесплатной облачной платформы следует выполнить несколько несложных настроек. В начале мы настроим бота, затем канал, и, наонец, внесем соответствующие настройки в OpenIPC Вашей камеры + +### Создание и настройка бота + +Инструкция по созданию бота имеется в самой прошивке, на странице насройки сервиса Telegram + +- В поиске вашего Telegram введите `BotFather`. Будьте внимательны, существует огромное количество ботов, сделанных максимально похожими на этот бот! У настоящего BotFather будет стоять отметка о верификации бота. +- Запустите бота, нажав `/start` +- Выполните `/newbot` и следуйте инструкциям бота. Введите название бота и имя бота. Последнее должно закачиваться на "bot" и начинаться с буквы. +- Если все сделано верно, то в ответ вам придет сообщение с токеном бота формата _XXXXXXXXXXX:AaAa-BbBbBbBb-CcCcCcCcCcCcCcCcCcCcCcCc_. Этот токен дает полный контроль над вашми ботом, следовательно не стоит передвать его третьим лицам или ботам, а также вводить в непроверенных местах! +- Введя команду `/mybots` можно по желанию настроить картинку бота, его описание и команды. В данный момент в этом нет необходимости. +- В сообщении с токеном также содержится ссылка на ваш новый бот. Перейдите по ней, убедитесь что бот запускается. + +### Создание и настройка канала + +Нет особой разницы, куда бот будет отправлять сообщение - в канал или в группу. Поэтому все, описанное ниже, будет справедливо и для групп также. + +- Зайдите в ваше приложение Telegram и нажимте "Создать Канал" (или "Создать группу") +- Введите название канала +- Сделайте канал **публичным** (да, это важно, потом сделаете его частным, если захотите) +- На этапе добавления пользователей начните вводить имя вашего бота в поиске. Добавьте бота и выдайте ему права администратора. +- Теперь вам необходимо выяснить Chat ID вашего канала (или группы). Эта функция скрыта по соображенгиям безопасности. Существует по крайней мере три способа получить Chat ID: + - Написать специальным ботам в телеграм (мы не будем так делать, не зная авторов этих ботов) + - Использовать запрос https к боту и изучив JSON ответ (можно, но достаточно сложно) + - Использовать Telegram WEB (Этот способ мы и будем использовать) + - Зайдите на [web.telegram.org](web.telegram.org) + - Подключите свой аккаунт телеграм + - Зайдите в ваш канал или группу и обратите внмание на адресную строку. В ней будет числовой идентификатор после символа `#`. Для групп и каналов он будет начинаться со знака `-` + - Добавьте `100` перед идентификатором канала или группы, сохранив предварительный `-`, например `-1001234567890`, где `1234567890` - это числовой идентификатор чата, полученный из веб-версии Telegram + +### Настройка OpenIPC + +В меню прошивки, в разделе **Services** выберите **Send to Telegram ** + +- В появившемся плагине активируйте настройку **Enable sending to Telegram** +- Ниже введите **Tокен** вашего бота, полученный ранее. +- Далее введите **Chat ID** вашей группы или канала. Не забудьте добавить `-100` +- Настройте остальные параметры отправки сообщения + +### Проверка работоспособности + +- Убедитесь в том, что в секции Preview отображается картинка с камеры. +- Получите доступ к консоли камеры, например используя SSH +- Выполните команду `send2telegram.sh -v` +- Если все введено верно, то в канал или группы придет сообщение, содержащее изображжение с камеры +- Вывод команды в консоли может пригодиться для изучения и отладки +