> For the complete documentation index, see [llms.txt](https://chatme-ai-4.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-messendzhery/microsoft-teams.md). # Microsoft Teams Microsoft Teams — корпоративная платформа, объединяющая в рабочем пространстве чат, встречи, заметки и вложения. Агента можно вывести в качестве Бота, который будет доступен внутри спейса компании. ## Подключение ### 1. Конфигурация на стороне Microsoft Teams В первую очередь нужно произвести конфигурацию на стороне Microsoft Teams. #### Подключение бота 1. Авторизуйтесь в Microsoft Teams. 2. Перейдите в раздел Приложения.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zgB8fDIfq4/aa4d1be38480ad0ef23639b6ecc3768edfbcb0e3fa5aa416aeb7901d57703177e657d4e21950d28008829976f4a9268afb74fb1c45fc5fb8dc2ec10c29e1de7d00b40932712a9c90f7bc1e6a4626054a8f6693e71fe1050ec59a78696620a6fa907ffac6) 3. В поиске найдите приложение Портал разработчиков и перейдите в него.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Jgcaq3D-6F/8a431463279ce4586ed1a5df7b11f0e2da335ac1432b1b45ef6c7adfce85c993b965bff83daf86eeca35f5a43e8c65d7d9530c8d48ad1dc6ec7252ee15dabcd6f82bec64bc76305b97d214ec3c212d7af03ee33b2b5c57b313097650df00b9257a380729) 4. Перейдите в раздел Инструменты → Управление ботами и добавьте нового Бота.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-FvwkF92gjf/434c1faecc7fe9f16951eb40eff0552a6dd7ba05407e21573a6c8ea5c77cce940969aa2c6d1b61645b19e06258a9b36a6edc803bade4c861331bb28ce058a3e304a6f54508d83584c85349e2b6cf2ed96deacce1d9d68dae76b05b1ba9bfaf65a7e3e219) 5. Укажите имя Бота и нажмите Добавить.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QR2AUwe_JZ/b23c8492be6af7c35fa19c7ec9626bbae10e9d0129cfb3e639679cb8f92b472c406eed654f02a6ca9a61869ecb28a9515b0fcf4b8f620c23216a95c4a0649a144a9ea8096798cd8a0eb58a48b0a65303ec0ede7d5cb7576d6692b9734c4e878930772754) 6. В поле Адрес конечной точки укажите вебхук канала агента (поле Chatme webhook: URL), который вы сможете получить при настройке канала агента на платформе.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-NM4DmkubGU/2bc0609952acf314a1d9581c360257b7f694e6cbc0114ecad99583365d89d9ffa14e3169bced517bc675c3d366b2cc50162aa20a71cfc8653fe9b8821f7b941172a6391255fc7a6d0d5c4a807ceaadb46f873643bc534775753cd0915b5abb27f2bb013f) 7. Перейдите в раздел Секреты клиента, нажмите кнопку Добавить секрет клиента для бота, и скопируйте куда-либо значение из поля. Оно понадобится при настройке канала агента на платформе.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-DkTtX--T5O/7d759df30fddba2d5618b9ad7f477d460a3ce441d37b4baa8a309d1fd8ce2071c666f3f00dcc83cdc957b477e9e277403fef9afa299f99bc79e911b39c9425f43dfdfe4d76d25a974dd50fa81371c81100226f548d87c5d68c66fe053f01a0ba14bffe6c)\ ![Screenshot\_11.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-neboKbh2Am/eb160865747d0981a45e98bfe4b5d802441166a9bb3d505643ffe693d180203272041c9828fa45232ad94168b9126903aff4d6327774a79a7394e407fa7bba2eec5f566d1887e1439af05d6cd73e255550391e8972b52706b4460e7909ed98b56229a69f) 8. Вернитесь в раздел Инструменты → Управление ботами и сохраните идентификатор Бота. Он понадобится при настройке канала агента на платформе.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-NXgZjSq0qU/091e718cc88311ea96be19cac30cdde0f718e45e5db6c676bb402fb8efc9f34b9e0051d0fa805cefb39fbeaeb1b4101145bd742b8e5ceba7a438c77702b5860685ef6e7808bcfb5de24aaa3724540cab04f7b9aeedb078bdbda5167959154fa654f13504) 9. Подготовьте zip-архив с приложением. В нем должны содержаться иконки для Бота и файл manifest.json с настройками бота. В файле manifest.json нужно указать идентификатор созданного Бота, имя и описание Бота в Teams. Также вы можете задать команды. Подробнее описано в Подготовка архива с приложением. 10. Перейдите в раздел Приложения → Управление приложениями.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-UgSYM0EwWs/2240690950b6ed6efe73d732810e95653590eb8c516a3807add7e015acdb494a90952c6a551f189c7e0a7f3a295519bde3cd0c633ce6adebb4ffd1babfff3b144de49256afb4aafa16f072cdeb8f51326a915449eea892ce5a4e3bd0bf6dea17971400ec) 11. Нажмите на Отправить приложение → Отправить приложение в вашу организацию и загрузите подготовленный архив manifest.zip.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Pl--GJPXND/16cf6adc393e689045d629997561bd815cba259b24ab583e897b3518e29dfd9167b738eb227a2654739310520c245cb5be9f750d2e7aae52940fc8c41434fdfe8f1405d565faf7dd4e2c26b3846f16a4ee46ba6b2edf3b281abbae685c71d03f5089acc1)\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zXkwqhu0AW/c6dd9629f39bdb5e32b59391287561a75b7f255c57da652f83b8686e0f0392bacf918ba364c8f3f431f6b45580cecee362d79bddff231692a5f8e75ac266fb749567fdda11b77d07cae35190b008dbf83276a0920c15f862531c4f01f6ebe3db4c944695) 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. Кликните по кнопке настроек Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m_bL4GvN1_/de0e6c51b47058d8e7854370e44e3e29e8d1195855e34484c55e0ba55e6f4cbc2f103ac4ebcc2b78bf606d6b02118303275d07760b64f89e5ea954cd86466379ab9850814435bbe8d5ab7d3e80e7ac68c8a471b3ba0022e97fb3209a771f11a86b6c817e) 2. Нажмите кнопку Add channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KJ7zJqauLN/e76804ae1c32c84507914bcbac89b59e5fa7160e857084643655c65f3192dbec4709a2cd8abae87edc6a858acbd80d17c3296d23c47a2c39eccf56433201a9779ccf4ea2580c347508e5f68b0ee94654585fa349ceadd2e6587a4bdebd6c5d9715835322) 3. Откроется панель выбора Конечный канал.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-CszIO55LMv/769196bc5e81c5e7c7e5767e3d270c0aae9c2bc4fff318b62b79055b43c84d2bb651590f75db7924e49fe806f6af4c9aa74979e2609e90b40b51580362c501067ec1b75d3d98b695b594a6208dbea270a6a6b8b8e54e249afc00fdbc9ab1513982474573) 4. Выберите Microsoft Teams. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-rmbBTR4c3j/7c057b68f18f20f36de65ac260327c0930404eea15b9b5454cadd2d0ba5626004b8a356a5280087f5f2642732470826497d8a32303ab94595954b638a5f13bb805adfc8cd1ac70d64a49ea131260c2db227b60b19def8ac69c2edc5d349ba51ba82c44e9) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-aKoCNtbpUT/8c03959dce19fae5a6afcb3cdfd24a1dc335645061ccd4b81971caec507e83dd296c1fbef0b2187fb300db667cdc76625fbde5e35f1937b6777aad126418474cd532fd9fb40a048383e45aaac701c51ca476d1e99f2ea3e195b8029d2b8e95d24b0dee2a) 7. Укажите секрет клиента для бота в поле Microsoft Teams webhook URL. Установите полученный в настройках бота Microsoft Teams идентификатор бота в поле Microsoft Teams Token.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QDu3KQWJs-/0c1441ac52a1fca6e8613b4acb767f504437518cadd8530975f4e5a79825d969fc14ec17dcf358fbcb0fcb205dec87edea183fb34bca24c4f873e053dec307a4d8fb4eea0022e120814dddbae779f992ab8de17b2f778f9ff2873a8873dd44013b7bb079) 8. В поле Chatbot webhook URL станет доступна ссылка на вебхук канала агента, которую нужно указать в качестве Адреса конечной точки в настройках бота в Microsoft Teams.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VrMVDeKKQy/40e6791145ac9088e6aba8942bbc73f856f6d0b2c123226b7092f6b5eba150204902215d9f3439a2a57a8d7be377a5c232ff732dc40d07fbbd34a4eef68f86f162feb3da4cfa2e0827024cfce039f50618a39cb98c95b6ea6a7140edd7dc60414f04ba8e) 9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-rAlwQzjo4E/0479ad9f833d58e33acd4d2c33e1ff508490f5cb7e5d8a41522f489a9238ca40ed77c8bcc6d0a9dc09b22e7f4b749343c71738d88de1fe8d212bc1e4ebfbd1230690433f20a19e99a1bed900d79c7e4da09a4a9d69944ddb06d61d97dca4c0b92f13ab97) 10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-LtXVWomQou/67db158af4c7d144fe0f76ea15e6026640f9676ae76be707c127575251b03f45f1707b743269ab21d628ce98b3eb8e69aeb0b46e907179857c7bfb1797466d6c2cd487d775654aa0b0a12d2688b1c78819b748371207d6ceba80cb47fe48f14c86d5d15b) 11. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-JVbIn131Lr/008dada212c03fe90ab7cbe4b5bc082d3687c1bb3ec28adc600a1f44e561b3d65f642c1a92bd62da50a16eb90d0cdabf8533b884bd4891e6452352f8f472730957dbb941f67a755f062b655764455a635474e5213615cc35e5daa719759105fb13d003a9) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-jJptEZ0LKw/dc4e488aa41753bdffa2806529bad0a7a5f123b1bd6664a3f7b1a9bd6f1d472e70bbfc581c0416477b1c1b7766a8fb5e0e1fcade95cc04a7f0910089fa886b8ce20d1d53a8a766e1d0614e264da5dedd2e88a9619ff9533e5badb77c218240f4423f5356) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Ci5ZHXbBeW/be46e24dfce410e2121d2a68f91e945a928f352557a56dfdc0bea9dfa5f8250177b619632f57ccfb59ebf7635334fb3cedcc2b630c95d08e5f21350c89e3c02f608674148f85e35127bb41548bbf05f9f32353a016523b607066a8c386d227e32bd12cde) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-9LKToRKJ3a/3c8128c7b514a344a81f3609c20f34d2d8a423381897e44682d98c3c4b94a7ed952992ac9cdf36c6911df6ba142821ceabbdfcf8fac3aaa326a760178df546d4fe93c928abd6415514cb0173f468dad0a3074c1b62733569011c7c2afba191759145207e) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--wVBew38W0/34c46eb319f3890c62292abb08b14671017caea3e0bb3a0a5156109ddc82f85f1d8db19e4b70494555f967fe5ee38d4af7d5d0a3bb9fc1611a85da93e6e3858992dea929e89b746b61ecb796f0ad13c8a46303d30c3e522c7de8e23d0617d8c1f083bec0) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Fjs3oydgKp/876ac89064a7772f6ec27862caaf10d58dfea1793abb3217852afd08bef5fc40d6cd50f257c0cc5d63fa9e0d454ccf12d6c46cad24684581f2d7afa1586b1772c708111e8596e0098d905cadfc572219040904df8d4a30ac7c035435326c2fef8f122332) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле Microsoft Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-asUFNm0ZXm/f4111508d74d988f9ff1e75959bc69bfec35a6b1ab92bdfb3bcdc93ddf11da9a0be1e65858578890f0a45408532e2c929b5c5b2b3b9786b562a92342d30e4ee84c03ed4181122c75e8ae9af5f176f3058aa7ff314299ea6dd099ff2e4a37e8e01e6d9e16) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-8HM31jCYsh/4820bc704598f42f3f1b01bb7a11819b0e4a686039d7a5ec0cbab9d939f9ea05b510a180c3456aabd821076335f751e3db8828d732026ae389bfc67284c850f4248947773c3474e2f73107a611a6254eb51f7dd063d47c4d44d4dc19d04aa05461cfb6b4) ## Общение | Переменная | Конечный канал | Переменная в запросе из канала | | --------------------------- | --------------- | ----------------------------------------- | | channel\_visitor\_id | Microsoft Teams | [from.id](http://from.id) | | channel\_conversation\_id | Microsoft Teams | [conversation.id](http://conversation.id) | | channel\_visitor\_firstname | Microsoft Teams | Нет | | channel\_visitor\_lastname | Microsoft Teams | Нет | | channel\_visitor\_account | Microsoft Teams | [from.name](http://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 | Нет | |