Подключение Telegram бота¶

Подключение бота к вашему серверу открывает для пользователей системы следующие возможности:

• Получение кодов для двухфакторной авторизации
• Получение уведомления о готовности клиента к подключению по приглашению
• Создание приглашений в Быстрой поддержке
• Подключение к устройствам из Постоянного доступа
  • Получение списка
  • Подключение
  • Обмен файлами

Подключение¶

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

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

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

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

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

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

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

Выполните следующие действия:

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

Веб-хуки¶

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

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

где:

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

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

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

Настройка сервера¶

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

В файле /opt/pro32connect/server/config.json добавьте следующую секцию:

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

где:

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

Перезапуск сервера¶

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

cd /opt/pro32connect
docker-compose restart

Готово! 👍

Проверка¶

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

Последнее обновление: 11 марта 2024 г.