Microsoft Teams

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

Подключение

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

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

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

1. Авторизуйтесь в Microsoft Teams.

2. Перейдите в раздел Приложения.

3. В поиске найдите приложение Портал разработчиков и перейдите в него.

4. Перейдите в раздел Инструменты → Управление ботами и добавьте нового Бота.

5. Укажите имя Бота и нажмите Добавить.

6. В поле Адрес конечной точки укажите вебхук канала агента (поле Chatme webhook: URL), который вы сможете получить при настройке канала агента на платформе.

7. Перейдите в раздел Секреты клиента, нажмите кнопку Добавить секрет клиента для бота, и скопируйте куда-либо значение из поля. Оно понадобится при настройке канала агента на платформе.

8. Вернитесь в раздел Инструменты → Управление ботами и сохраните идентификатор Бота. Он понадобится при настройке канала агента на платформе.

9. Подготовьте zip-архив с приложением. В нем должны содержаться иконки для Бота и файл manifest.json с настройками бота. В файле manifest.json нужно указать идентификатор созданного Бота, имя и описание Бота в Teams. Также вы можете задать команды. Подробнее описано в Подготовка архива с приложением.

10. Перейдите в раздел Приложения → Управление приложениями.

11. Нажмите на Отправить приложение → Отправить приложение в вашу организацию и загрузите подготовленный архив manifest.zip.

12. После утверждения приложения админом вашего спейса, приложение (Бот) будет доступен пользователям спейса во вкладке Приложения.

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

Тип архива: 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”.

1. Кликните по кнопке настроек Агента.
2. Нажмите кнопку Add channel.
3. Откроется панель выбора Конечный канал.
4. Выберите Microsoft Teams.
5. Откроется панель создания Канал Проекта.
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
7. Укажите секрет клиента для бота в поле Microsoft Teams webhook URL. Установите полученный в настройках бота Microsoft Teams идентификатор бота в поле Microsoft Teams Token.
8. В поле Chatbot webhook URL станет доступна ссылка на вебхук канала агента, которую нужно указать в качестве Адреса конечной точки в настройках бота в Microsoft Teams.
9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
11. 1. Канал Проекта будет сохранен и активирован, если:
    2. 1. Агент обучен;
       2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
3. 1. Изменения будут применены, если:

   2. 1. Агент обучен;
      2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения не будут применены, если одно или больше условий не будут выполнены.

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:
   2. 1. Агент обучен;
      2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Переменная	Конечный канал	Переменная в запросе из канала
channel_visitor_id	Microsoft Teams	from.id
channel_conversation_id	Microsoft Teams	conversation.id
channel_visitor_firstname	Microsoft Teams	Нет
channel_visitor_lastname	Microsoft Teams	Нет
channel_visitor_account	Microsoft Teams	from.name
channel_visitor_phone	Microsoft Teams	Нет
channel_visitor_email	Microsoft Teams	Нет
channel_visitor_source	Microsoft Teams	Нет
channel_visitor_auth	Microsoft Teams	Нет
channel_visitor_location	Microsoft Teams	Нет
channel_message_id	Microsoft Teams	Нет
channel_message_recipient	Microsoft Teams	Нет

Функционал общения	Конечный канал	Доступность в канале	Примечания
channel_chat_id	Microsoft Teams	Да	Формат: channel_visitor_id|teams
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Microsoft Teams	Да
Кнопки	Microsoft Teams	Да
Перевод на оператора	Microsoft Teams	Нет	В Microsoft Teams нет такого функционала
Передача файлов в виде файлов от Агента (Attachment)	Microsoft Teams	Да
Передача файлов в виде ссылок от Агента (Attachment)	Microsoft Teams	Да
Получение файла от Собеседника в сценарий	Microsoft Teams	Да
Получение геолокации от собеседника в сценарии	Microsoft Teams	Нет
Доставка сообщений более 1000 символов от Агента до Собеседника	Microsoft Teams	Да
Получить ссылку на источник лида	Microsoft Teams	Нет
Использование маркдауна	Microsoft Teams	Нет
Рассылки с помощью Notification	Microsoft Teams	Нет