Канал Teams
Перед добавлением канала в систему необходимо настроить его со стороны мессенджера.
Настройка канала в Teams Регистрация приложения 1. Необходимо ввести данные учетной записи на
https://portal.azure.com.
2. Далее выберите App registrations.
3. Нажмите New registration.
4. Укажите название приложения, затем выберите типы аккаунтов «Multitenant» и нажмите «Register».
5. В меню слева выберите Certificates & secrets и нажмите «New client secret».
6. Впишите название секретного ключа, укажите срок истечения и нажмите «Add».
7. Рекомендуем Вам скопировать и сохранить секретный ключ в любое защищенное место.
Внимание! В следующий раз ключ будет скрыт и посмотреть его будет нельзя! Если забыли скопировать ключ, можно создать второй без пересоздания приложения, таким же образом.
8. В меню слева нажмите «Overview».
9. Скопируйте «Application ID».
Регистрация бота 1. Необходимо ввести данные учетной записи на
https://dev.botframework.com.
2. Перейдите по ссылке
https://dev.botframework.com/bots/new.
3. Введите название и уникальный идентификатор бота. Идентификатор без пробелов, только с _ разделителем.
4. Введите адрес вебхука, на котором бот будет принимать сообщения.
Адрес вебхука – это «Адрес сервера для API» в настройках добавления канала.
5. Вставьте скопированный «Application ID» из п. 9 (
Регистрация приложения).
6. Далее необходимо согласиться с условиями и нажать «Register». После этого необходимо подтвердить успешную регистрацию.
Регистрация каналов бота
1. Выберите в верхнем меню «My bots»
2. Выберите бота.
3. Выберите канал.
4. Нажмите «Save».
5. Далее необходимо согласиться с условиями и нажать «Agree».
Настройка канала в Teams
1. Перейдите в конфигурацию заказчика и создайте новый канал с типом «msbot».
2. Введите идентификатор и идентификатор канала. Идентификатор должен соответствовать окончанию адреса вебхука из п. 4 (см. п.
Регистрация бота).
3. Вставьте «Bot ID» из п. 3 (см. п.
Регистрация бота)
4. Вставьте «Application ID» из п.10 (см. п.
Регистрация приложения)
5. Вставьте «Application Password» из п.8 (см. п.
Регистрация приложения)
6. Сохраните конфигурацию.
Включение отправки файлов в боте Для включения отправки и получения файлов в боте необходимо зарегистрировать бота в Teams. Для этого необходимо выполнить операции в следующей последовательности:
1. Найти в поиске по приложениям в Teams приложение «App Studio».
2. Создать новое приложение.
3. Ввести любое короткое имя приложения.
4. Указать идентификатор приложения из Azure («Application ID» из п.10
Регистрация приложения).5. Указать названия пакета и версию.
6. Ввести краткое и полное описание бота.
7. Ввести название компании и веб-сайт.
8. Указать ссылки на заявление конфиденциальности и условия использования.
9. Перейти на вкладку «Bots» и нажать «Set up».
10. Выбрать вкладку «Existing bot», затем выбрать опцию «Select from one of my existing bot», из выпадающего списка выбрать нужного бота.
11. Выбрать опцию «My bot supports uploading and downloading files» для поддержки отправки и получения файлов, выбрать область видимости бота «Personal» и «Team» и нажать «Save».
12. Перейти на вкладку «Test and Ddistribute» и нажать «Install». Откроется окно информации о боте.
13. Нажать «Add».
14. После этого произойдет переход в бота. В боте должна появиться кнопка со скрепкой для отправки файлов.
15. При получении файла (за исключением картинок) от бота клиент сможет принять или отклонить получение файла.
Системным администраторам Убедиться, что открыт адрес из п. 4
Регистрации бота.
Убедиться, что открыты доступы к хостам:
Часто задаваемые вопросы по настройке канала Teams Вопрос: Как попасть на своего бота?
Ответ: Просто нажать на нужный канал в сервисе регистраций бота (
https://dev.botframework.com) в списке. Отсюда же, поделиться с кем-то ботом, можно скопировав ссылку из прямо из браузера
Вопрос: Все точно сделали правильно и по инструкции, только принимает сообщения, но не отвечает?
Ответ: Часто требуется подождать некоторое время для регистрации бота. Были случаи, когда бот начинал работать через час после регистрации и когда только на следующий день. Это зависит от работы Azure.
Добавление канала Teams в системе 1. Переходим в меню добавление канала («Настройки проекта» - «Каналы»), нажимаем кнопку «Добавить канал» и выбираем необходимый канал.
2. Добавьте название канала. В случае необходимости указать агента обработки сообщений, отличного от агента обработки сообщений в системе по умолчанию, выбираем агента обработки сообщений из выпадающего списка в одноименном пункте настроек канала.
3. Добавьте следующие данные:
- идентификатор приложения (из шага 10);
- пароль приложения (из шага 8);
- идентификатор бота (из шага 3).
4. Сохраните введенные изменения.
Ваш канал добавлен и готов к работе!
Дополнительные настройки канала Teams в системе
При желании на вкладке «Внешний вид» Вы можете изменить текст после выставления пользователем оценки консультации. На вкладке «Дополнительно» Вы можете указать Webhook предобработки сообщений