Настройка и развертывание Telegram-бота

Owned by Губин Максим
Last updated: авг. 28, 2020 by DataScience Team (Unlicensed)
2 min read

 

 

Чтобы использовать Telegram-бот с ViTalk необходимо:

  1. Пройти предыдущие шаги настройки ViTalk

  2. Получить Docker-образ vitalk-tg с Telegram-ботом

  3. Получить Token для нового бота

  4. Создать директорию и файл с конфигурацией.

  5. Настроить доступ пользователей Telegram к ViTalk

  6. Запустить docker-образ

Получение Docker-образа vitalk-tg

Для авторизации в Яндекс-репозитории получите oauth-токен по ссылке:

https://cloud.yandex.ru/docs/container-registry/operations/authentication#oauth

Далее, воспользуйтесь командой docker login

docker login cr.yandex

В качестве username введите oauth, в качестве пароля - полученный токен.

Далее, при наличии доступа к Яндекс-репозиторию Visiology получить Docker образ можно командой:

docker pull cr.yandex/crpfqub5060djadd5ic8/visiology/vitalk-tg:master

 

Получение токена для нового бота

Токен бота - это средство, при помощи которого конкретный бот связывается с управляющей программой. Чтобы получить токен бота необходимо:

  1. Войти в Telegram

  2. Обратиться к боту @BotFather

     

  3. Ввести команду /newbot

  4. Выбрать имя бота (которое будет отображаться в диалоге с ним)

     

  5. Выбрать username бота (по которому его можно найти в Telegram). Это имя должно заканчиваться на ‘bot’.

     

  6. Сохраните полученный токен

Конфигурация бота

Выберите директорию для хранения конфигурации. В данном примере выберем директорию /docker-volume/vitalk-tg

sudo mkdir /docker-volume/vitalk-tg cd /docker-volume/vitalk-tg

Создайте в этой директории файл bot_config.json и заполните его:

В поле token вставьте заранее полученный токен бота.

Если ViTalk запущен вместе с платформой, в поле vitalkUrl вставьте:

Настройка доступа к ViTalk в Telegram

Авторизация Telegram-пользователей осуществляется через белый список id пользователей. Права доступа к данным через Telegram-бот соответствуют роли, прописанной в настройках соединения.

Настройка доступа:

  1. В директории /docker-volume/vitalk-core/configuration создать файлtelegram_whitelist.json с содержимым:

  1. На место <telegram_id_*> подставьте telegram-id пользователя как целое число. Чтобы получить свой id, вы можете обратиться к боту @my_id_bot.

  1. Перезапустить контейнер vitalk-core:

Если список пользователей поменяется, вы можете в дальнейшем редактировать этот файл, после чего необходимо перезапустить контейнер vitalk-core.

Отключение авторизации

Бот возможно (но не рекомендуется) сделать доступным для всех пользователей Telegram. Для этого нужно изменить файл /docker-volume/vitalk-core/configuration/telegram_whitelist.json следующим образом:

После изменения необходимо перезапустить контейнер vitalk-core:

Запуск бота

После настройки для запуска бота необходимо выполнить команду:

Убедиться в отсутствии ошибок при запуске можно при помощи команды:

Протестируйте бота, обратившись к нему в telegram, по ранее выданному username: