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.
Нажмите кнопку Add another channel ​
image.png
⁠
⁠
Интеграция с Microsoft Teams происходит через
@Коннектор
⁠
с названием “Microsoft Teams”, установите его в поле Channel.
⁠
image.png
⁠
⁠
По необходимости пропишите заголовок для данного
@Канал Агента
⁠
в поле Title. ​
image.png
⁠
⁠
После выбора “Microsoft Teams” вам станет доступна ссылка на вебхук канала агента (поле Chatme webhook: URL), которую вам нужно указать в качестве Адреса конечной точки в
настройках бота
⁠
в Microsoft Teams. Выделить URL полностью можно двойным кликом. ​
Slots (1).jpg
⁠
⁠
Установите полученный в настройках бота Microsoft Teams
идентификатор бота
⁠
в поле Channel webhook: URL в окне настроек
@Канал Агента
⁠
.
Укажите
секрет клиента
⁠
для бота в поле Channel webhook: Token. ​
Slots (2).jpg
⁠
⁠
Активируйте канал переключением тумблера для того, чтобы
@Агент
⁠
начал отвечать в нем.
Если
@Агент
⁠
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
⁠
а, после чего повторить попытку активации
@Канал Агента
⁠
.
⁠
image.png
⁠
⁠
После активации
@Канал Агента
⁠
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
⁠
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
⁠
image.png
⁠
⁠
Сохраните
@Канал Агента
⁠
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

Общение

Маппинг Канальных переменных из Microsoft Teams
Not synced yet
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
Особенности
1
channel_visitor_id
Microsoft Teams
from.id
​
2
channel_conversation_id
Microsoft Teams
conversation.id
​
3
channel_visitor_firstname
Microsoft Teams
Нет
​
4
channel_visitor_lastname
Microsoft Teams
Нет
​
5
channel_visitor_account
Microsoft Teams
from.name
​
6
channel_visitor_phone
Microsoft Teams
Нет
​
7
channel_visitor_email
Microsoft Teams
Нет
​
8
channel_visitor_source
Microsoft Teams
Нет
​
9
channel_visitor_auth
Microsoft Teams
Нет
​
10
channel_visitor_location
Microsoft Teams
Нет
​
11
channel_message_id
Microsoft Teams
Нет
​
12
channel_message_recipient
Microsoft Teams
Нет
​
13
channel_webhook_url
Microsoft Teams
serviceUrl
​
There are no rows in this table
⁠
Возможности общения в Microsoft Teams
Not synced yet
Функционал
Конечный канал
Наличие в канале
Описание
1
channel_chat_id
Microsoft Teams
Да
Формат: channel_visitor_id|teams
2
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
Microsoft Teams
Да
​
3
Кнопки
Microsoft Teams
Да
​
4
Перевод на оператора
Microsoft Teams
Нет
В Microsoft Teams нет такого функционала
5
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Microsoft Teams
Да
​
6
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Microsoft Teams
Да
​
7
Получение файла от Собеседника в сценарий
Microsoft Teams
Да
​
8
Получение геолокации от собеседника в сценарии
Microsoft Teams
Нет
​
9
Доставка сообщений более 1000 символов от Агента до Собеседника
Microsoft Teams
Да
​
10
Получить ссылку на источник лида
Microsoft Teams
Нет
​
11
Использование маркдауна
Microsoft Teams
Нет
12
Рассылки с помощью Notification
Microsoft Teams
Нет
​
There are no rows in this table
⁠

Подключение
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.