> 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/vk-teams.md). # VK Teams [VK Teams](https://teams.vk.com/) — корпоративный суперапп для коммуникаций и совместной работы команд. ## Подключение ### 1. Конфигурация на стороне VK Teams Создание Бота на стороне VK Teams описано в статье: . 1. Откройте VK Teams и авторизуйтесь. 2. Найдите в поиске бота “metabot”. 3. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-UQe6UWrRCD/9c022f612bf7023f56d445a7a68c365b9e3efa571242133f044a760e4ea713b85d6735eae5ea2fd53d61619afb1cf17cf6159636a4854412fae3b8da29d2ca58e82c9b385340343895b9a5d1d2398cf1bbc50042916cb7d3863cb5e125ea1ec5d728253c) 4. 1. Отправьте Боту команду/newbot 2. В ответ на сообщение бота введите желаемое имя вашего Бота.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-XjcX0fhoc9/9dc26c11cfea6acf3ddb4595cd79a9c8278bd25e1e942ec6bd95f41f0f529b0b5425dafa445a6fe547ff99126cc290ad0730590ed95d6d418d74d05d328b2afb4e3748faa2e89c2cca74e5a8176c040e60c0d5f3c1b147db3603b74343302c9377b60108) 5. Скопируйте полученный токен.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Tjw574J1Pq/709fc1cde0a7f8cd27d60ca21fd61758e0aa97ba9ad48ea45d2309fddc03a75e802f3186fe6f03c0539586669e7aab372ddde1f8493d821f2b6ed72aa5379523271f108523575ca5245b3ac280c92a40b119c02a317b479e9bdcdf2c96741f022be4ad73) ### 2. Конфигурация канала агента в Платформе Агенту необходимо создать и настроить Канал Проекта с Коннектором “VK 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-vmOO_OCTx4/2e68f5743c708564b91fe344315f6ce726ea10acb23de2fee13bf71c460fd347a670c5f8cde696293116919bf479c71fb4fae529826ccea0cbf373b3b401876dfe6ccac46ff69c0d248649a5664d2555c0f70dea00abe5c5b486818ec622c04432ff3b35) 4. Выберите VK Teams. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-WNCnVofGv-/851b884ec958f08cdd80502299bcb2eca6b486f3406dde1f14ed41a5106538df24bad4dc6828cec48059979dd49e0237ff7c5e19a03435555616f41f5ee6123133ea881b2f76e01d66aff2960e8b68aa85882c40a6f3da1d04f95198c4954bd2c0550040) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-w__HeIjeM-/390af5aa843556ce56376a03ad9e33cc7f7bdfc3a33ed066a7462ffca678402da08b4ca4cef208220aef9445e079f7f55fd5a284cd6e985e91762c9f0bddce186fa5f1089c0cabeb4e39780adc3a0188ebe13aaf1a01dfb4b14875bb364fc519bc4e0a67) 7. Вставьте скопированный ранее токен в поле VK Teams token.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-RULLkPstr8/91162a8663f76a45179b951c45ba804eff463b0645008099b8e50bc87d78b95b8ef4b2cad9dfdb080ec325c00579b9d87e8a8344929d960acb7773b5af96c76894ce7fc8cc67f7cc289d4d2a99c82f230ba1a753b0e46e3b39b6e9eda340f10bb83aa465) 8. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-_o9HpC8uZP/01e77cce8b84dc0e99e01bc7b447c4e8f284a08d1246b248ac1143884e3775fd35d958653bdd46f314280d8d69d6ba208f970b86c73004a7a01be38fecab4f5693a3b0219e9491c70caad1ac6d73b03015651e0e37ea7216c9c9249ff5ca8c8cd4c7f504) 9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-I45G4RN4cl/648627c02989f588e50679e715f04c65771a9b06023a405e95ebc54935756b59d4fb5ef4284a33f52c3d2056fe14fba20d565a63a9af00ed65870abe282222aeceb3d1bf6237b3cca34f3e6f1192b9fd33ed2d5576a2500c20adbda5934891ce3e4a510b) 10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-NelEbNJts9/95b6628619ff4223401016ca6e45c80d168e2fbbd4d96a8031a10f7a9961df8dd9c954be8def65b02e05756fa90711e88ea2598eed8db6fdaba26dc4f09548da48655054274d2f3c21c2f2123629005b3d7bee68acaefee90352c31cd41c3f4c6ab6a459) 11. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-DpM5tJT9tx/5cba161506641a6941ea5e681cb99c2c17979c375eedc661e026c7c6429543730500285768540a58c50a456687ba5527ec52710279856290ab26c3e48ffad1baf33fc2bdece138dd9d53b74541de4755d6382f91866155b1c49663bce9ce23910b7b0983) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-IS3VamBBfF/7752269ab72f54b0945bdc0113290a706f30ec8c785c036b63d997464971490dc40eef99154ed323c1a9641ac16a0685e5310d8e09eeadd159b82c6ddde2c8f47cc8bbec233fb51c8c7f83b6161852195e1099bc706ad690f28443e223a6d9c51ded958c) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ATNX401Wzg/7b688448027a2200a6ffe13ebd375144d34d170227807d001f713adea8b5e6a6420b324d1dea1b3f2ddf2f0cad056d95331735abe37a1037c4c70fc335673ffe2d66d07ab2f4d5932254841f377c416216cdf865231ce9b3058bab691c4d46acb27dd030) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-wmG33sMCyq/4a3e01282d9380d812cd000cb1bbb6f8d237dd4d88a85d0aec7d3faacd4b253d6ff35b349d9cb3e45ea4e178788ef08ea663708b2d59a27a13586a35e2e737a7d0ae86bfebc9c3b154eedb98b2155da79399be667eb1dc094c2ffe3714d1c085f4075a20) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zijMBxu7eo/13b98ca7b29cf5248dd1a078fc31bab64618059680a3731e7551b57c4f8029dddae748d65e13f0ee5d8703d9dc0918cec4d12506745fc0f0e3775726136116e40ac79c6c8e2844931753c05e29ac9546c65956e468bd40df91ece69b2a44a85de13d5b99) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-T2RZh3mLT_/fc792282018823e497add55f5b517960c029ec43c078bdb75ab61d3acd42bf39f0426d829b7cbf70298d415b2d161ec8332046e32551dfdf4a731b89ef735af1fc6294fb21b3a0634848bf369a1c8b2d420d7a567f247648891b847b145eb1cdc333c7de) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-0KCZrNmgk0/c283b83f72849a2e0ab4c8442ffd7afafb9b8a543e0172b9ee01bed0a4448b492eeab963542a8db5a7429427cc0ba775469b042d12e672780ee64cbf099dcf642ef4852476772e9723770be86631bf2121a0235e7c5e3196fa4191445110088a6848671f) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ZHFlxdLuG0/72a258d3435e90a61c04857ed2cdb78912be99893c6cb56a1e9d711cd80387b9e8234bc43c50a931e687a4f4d7c5d951e906c9913fbe00ada7b7c0bb6ac4a31cb37377c144cdf73f31077c04a87457c6027764ec8f9400297f4a919aa428c805676ea554) ## Общение ### Общение в чатах Для общения Бота в чатах VK Teams необходимо разрешить добавлять Бота в чаты. Для этого необходимо: 1. Перейти в [@metabot](http://teams.vk.com/profile/70001) 2. Отправить ему команду /setjoingroups, отправить ник или Id своего Бота, отправить слово enable.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-IrSnH2mFD5/e1c6ad2ef6473ccab5467071a77ee34d069ab92b2ca827214d44dd8733d1f82769528a362a93ef37d04fcb44aa681f8aa4edec161d13628ea7b68fbe8ca084281f40b1ee5e22c1836c649a696fc2fa5bd92188f14b44d36bd6efba97bd9633216da5b5f6) 3. После этого Бота можно будет добавлять в чаты. | Переменная | Конечный канал | Переменная в запросе из канала | Примечания | | --------------------------- | -------------- | ------------------------------ | ---------- | | channel\_visitor\_id | VK Teams | from.userId | | | channel\_conversation\_id | VK Teams | Нет | | | channel\_visitor\_firstname | VK Teams | from.firstName | | | channel\_visitor\_lastname | VK Teams | from.lastName | | | channel\_visitor\_account | VK Teams | Нет | | | channel\_visitor\_phone | VK Teams | Нет | | | channel\_visitor\_email | VK Teams | Нет | | | channel\_visitor\_source | VK Teams | Нет | | | channel\_visitor\_auth | VK Teams | Нет | | | channel\_visitor\_location | VK Teams | Нет | | | channel\_message\_id | VK Teams | msgId | | | channel\_message\_recipient | VK Teams | Нет | | | channel\_service\_data | VK Teams | Нет | | ### Сервисные сообщения из VK Teams На данный момент не поддерживается передача Сервисные сообщения канала VK Teams. | Функционал общения | Конечный канал | Доступность в канале | Примечания | | ------------------------------------------------------------------------------ | -------------- | -------------------- | ----------------------------------------------------------------------------------------------------- | | channel\_chat\_id | VK Teams | Да | Имеет формат: chat.chatId\|vk\_teams | | Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | VK Teams | Да | | | Кнопки | VK Teams | Да | Кнопки выводятся инлайн, по одной кнопке в строке, максимум 14 кнопок | | Перевод на оператора | VK Teams | Нет | | | Передача файлов в виде файлов от Агента (Attachment) | VK Teams | Частично | Приложение отправляется ссылкой из поля Source Слота Attachment , которую VK Teams преобразует в файл | | Передача файлов в виде ссылок от Агента (Attachment) | VK Teams | Да | | | Получение файла от Собеседника в сценарий | VK Teams | Да | Формат: file:Тип файла\|ID файла\|Ссылка на файл | | Получение геолокации от собеседника в сценарии | VK Teams | Нет | | | Доставка сообщений более 1000 символов от Агента до Собеседника | VK Teams | Да | | | Получить ссылку на источник лида | VK Teams | Нет | | | Использование маркдауна | VK Teams | Нет | | | Рассылки с помощью Notification | VK Teams | Нет | |