Настройка и развертка бота в организации

Как настроить бота

1. Создать приложение
   1. Перейти в Apps
   2. Клик на Import app и импорт файла. Файл содержит в себе манифест приложения и иконки бота.
2. Создать бота
   1. Перейти в Bot management
   2. В Configure указать вебхук бота (https://<хост_бота>>/api/webhook), по которому Microsoft Teams API будет отправлять входящие ивенты
   3. В Channels убедиться, что стоит галочка в Microsoft Teams
3. Привязать бота к приложению
   1. Вернуться к своему приложению в Apps
   2. Внутри бота есть вкладка App features → Bot → Identify your bot → Select an existing bot -> выбрать ранее созданного бота
4. Заполнить переменные окружения бота (для добавления потребуется разработчик)
   1. MICROSOFT_TENANT_ID – перейти в Microsoft Entra ID своей организации → Basic information → Tenant ID
      Это нужно для получения информации об идентификаторе личного чата с пользователем, чтобы бот мог отправлять автономные сообщения (например, алерты).
   2. MICROSOFT_APP_ID – перейти в Bot management → Bot ID
   3. MICROSOFT_APP_PASSWORD – перейти в Bot management → Client secrets → Add a secret
      Это нужно для проверки подлинности запросов между самим ботом и службой Bot Connector
   4. BACKEND_API_URL – корневой URL-адрес API бэкенда
      По умолчанию в локальной среде разработчика используется значение http://localhost:5000/api/v1
5. Заполнить переменные окружения backend сервиса (для добавления потребуется разработчик)
   1. MICROSOFT_BOT_BASE_URL – URL-адрес бота
      По умолчанию в локальной среде разработчика используется значение http://localhost:3978

Как развернуть бота в своей организации

1. Перейти к боту в Apps → Publish to org → Publish your app
2. IT-admin организации должен принять запрос на публикацию приложения (бота)
3. Публикация приложения занимает в среднем 5 минут

В случае, если вы изменили некоторую информацию в приложении бота в Apps, то нужно развернуть новую версию бота в организации

1. перейти к боту в Apps
2. изменить версию бота в Basic information → Version
3. Publish to org → Submit app update

Как добавить бота в команду

Ботом невозможно пользоваться в приватных каналах. В Microsoft Teams это не поддержано.