Настройка Telegram-бота¶

Интеграция с Telegram используется для отправки кодов двухфакторной аутентификации, получения уведомлений и доступа к персональной панели управления, когда техник включает интеграцию для своей учетной записи.

Интеграция с Telegram

Узнайте, какие функции становятся доступными техникам при включении интеграции в руководстве Удалённый доступ к рабочему столу через Telegram.

В этом пошаговом руководстве вы научитесь создавать Telegram-бота и подключать его к компоненту Server.

Создание бота¶

Сначала необходимо создать собственного бота в Telegram. Для этого перейдите к конструктору ботов @BotFather и нажмите Start.

Далее выполните команду /newbot. Чат запросит имя и ID для вашего бота. Используйте название вашей компании и постфикс PRO32 Connect.

После создания чат выдаст вам идентификатор и токен для интеграции с ботом:

Настройка бота¶

Теперь необходимо привязать доменное имя и настроить вебхуки для бота.

Доменное имя¶

Выполните следующие шаги:

Отправьте команду чату /mybots и выберите только что созданного бота.
Перейдите в Bot Settings Domain Set Domain
Укажите доменное имя вашего сервера

Вебхуки¶

Чтобы установить вебхук, откройте в браузере (или используйте CURL/WGET) следующую ссылку:

https://api.telegram.org/bot<bot-id>:<bot-token>/setWebhook?url=https://<your-domain>/webhook/telegram/<bot-id>:<bot-token>

Где:

<bot-id> — ID вашего бота
<bot-token> — токен бота
<your-domain> — домен вашего сервера

Если всё сделано правильно, вы получите ответ:

{"ok":true,"result":true,"description":"Webhook was set"}

Настройка компонента Server¶

Теперь необходимо указать параметры бота в конфигурации компонента Server.

В файле /opt/pro32connect/server/config.json добавьте следующий раздел Интеграция Telegram:

server/config.json

"integrate": {
  "telegram": {
    "name": "<bot-name>",
    "id": <bot-id>,
    "token": "<bot-id>:<bot-token>"
  }
}

Где:

<bot-name> — имя вашего бота
<bot-id> — идентификатор
<bot-token> — токен
<your-domain> — домен вашего сервера

Перезапуск компонента Server¶

Чтобы изменения конфигурации вступили в силу, перезапустите компонент Server:

Bash

cd /opt/pro32connect
docker-compose restart

Проверка¶

Ссылка на вашего бота должна появиться на странице интеграции в личном кабинете: