Skip to content
Gallery
Docs
История изменений
История релизов
НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ
ПЕРЕД СОЗДАНИЕМ АГЕНТА
КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА
СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ
ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА
РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ
ЭКСПЛУАТАЦИЯ АГЕНТА
АНАЛИТИКА ОБЩЕНИЯ АГЕНТА
РЕАЛИЗАЦИЯ КЕЙСОВ
ДЛЯ РАЗРАБОТЧИКОВ
ПРИЛОЖЕНИЯ
New Change Chat Mode
Share
Explore
Вывод Агента в мессенджеры

icon picker
Microsoft Teams

Microsoft Teams — корпоративная платформа, объединяющая в рабочем пространстве чат, встречи, заметки и вложения.
@Агент
⁠
а можно вывести в качестве
@Бот
⁠
а, который будет доступен внутри спейса компании.

Подключение

1. Конфигурация на стороне Microsoft Teams

В первую очередь нужно произвести конфигурацию на стороне Microsoft Teams.

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

Авторизуйтесь в Microsoft Teams.
Перейдите в раздел Приложения. ​
image.png
⁠
⁠
В поиске найдите приложение Портал разработчиков и перейдите в него. ​
image.png
⁠
⁠
Перейдите в раздел Инструменты → Управление ботами и добавьте нового
@Бот
⁠
а. ​
image.png
⁠
⁠
Укажите имя
@Бот
⁠
а и нажмите Добавить. ​
image.png
⁠
⁠
В поле Адрес конечной точки укажите вебхук канала агента (поле Chatme webhook: URL), который вы сможете получить при
настройке канала агента на платформе
⁠
. ​
image.png
⁠
⁠
Перейдите в раздел Секреты клиента, нажмите кнопку Добавить секрет клиента для бота, и скопируйте куда-либо значение из поля. Оно понадобится при
настройке канала агента на платформе
⁠
. ​
image.png
⁠
​
Screenshot_11.png
⁠
⁠
Вернитесь в раздел Инструменты → Управление ботами и сохраните идентификатор
@Бот
⁠
а. Он понадобится при
настройке канала агента на платформе
⁠
. ​
image.png
⁠
⁠
Подготовьте zip-архив с приложением. В нем должны содержаться иконки для
@Бот
⁠
а и файл manifest.json с настройками бота. В файле manifest.json нужно указать идентификатор созданного
@Бот
⁠
а, имя и описание
@Бот
⁠
а в Teams. Также вы можете задать команды. Подробнее описано в
Подготовка архива с приложением
⁠
.
Перейдите в раздел Приложения → Управление приложениями. ​
image.png
⁠
⁠
Нажмите на Отправить приложение → Отправить приложение в вашу организацию и загрузите подготовленный архив manifest.zip. ​
image.png
⁠
​
image.png
⁠
⁠
После утверждения приложения админом вашего спейса, приложение (
@Бот
⁠
) будет доступен пользователям спейса во вкладке Приложения.

Подготовка архива с приложением

Тип архива: zip ​Содержимое архива:
manifest.json — файл с JSON-ом, в котором прописана информация о
@Бот
⁠
е, командах и разрешениях.
icon.png — иконка приложения.
Пример manifest.json:
Важно: обязательно укажите идентификатор своего
@Бот
⁠
а в полях id и bots.botId.
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.14/MicrosoftTeams.schema.json",
"manifestVersion": "1.14", //версия манифеста приложения для Microsoft Teams
"version": "1.0.0", //версия приложения
"id": "93b81ba4-4572-4387-8568-37a4a76675f7", //идентификатор бота, полученный из "Управление ботами"
"packageName": "com.teams.sample.teamsconversationbot", //имя пакета приложения
//информация о разработчике приложения, включая имя, URL веб-сайта, политику конфиденциальности и пользовательское соглашение
"developer": {
"name": "teamsConversationBot",
"websiteUrl": "https://www.microsoft.com",
"privacyUrl": "https://www.teams.com/privacy",
"termsOfUseUrl": "https://www.teams.com/termsofuser"
},
"icons": {
"outline": "icon-outline.png", //иконка с черной обводкой
"color": "icon-color.png" //цветная иконка
},
"name": {
"short": "TeamsConversationBot", //короткое имя бота
"full": "TeamsConversationBot" //полное имя бота
},
"description": {
"short": "TeamsConversationBot", //краткое описание бота
"full": "TeamsConversationBot" //полное описание бота
},
"accentColor": "#FFFFFF", //основной цвет приложения
"bots": [
{
"botId": "93b81ba4-4572-4387-8568-37a4a76675f7", //идентификатор бота, полученный из "Управление ботами"
"scopes": [
"personal",
"groupchat",
"team"
],
"isNotificationOnly": false, //указывает, является ли бот только уведомлением или может отправлять сообщения
"supportsCalling": false, //указывает, поддерживает ли бот звонки
"supportsVideo": false, //указывает, поддерживает ли бот видео
"supportsFiles": false, //указывает, поддерживает ли бот файлы
//список доступных команд
"commandLists": [
{
"scopes": [
"personal",
"groupchat",
"team"
],
"commands": [
{
"title": "MentionMe",
"description": "Sends message with @mention of the sender"
},
{
"title": "Show Welcome",
"description": "Shows the welcome card"
},
{
"title": "MessageAllMembers",
"description": "Send 1 to 1 message to all members of the current conversation"
}
]
}
]
}
],
//разрешения, запрашиваемые приложением
"permissions": [
"identity",
"messageTeamMembers"
],
"validDomains": []
}

2. Конфигурация канала агента в Платформе

⁠
@Агент
⁠
у необходимо создать и настроить
@Канал Агента
⁠
с
@Коннектор
⁠
ом “Microsoft Teams”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
⁠
а.
⁠
image.png
⁠
⁠
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Messaging.
Подключение
1. Конфигурация на стороне Microsoft Teams
Подключение бота
Подготовка архива с приложением
2. Конфигурация канала агента в Платформе
Общение
Маппинг Канальных переменных из Microsoft Teams
Возможности общения в Microsoft Teams
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.