> 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.md). # VK [VK](http://vk.com) — социальная сеть, имеющая веб-версию, версию для мобильных устройств и мобильное приложение. Включает в себя функционал мессенджера и публичных сообществ, куда в качестве оператора, отвечающего на сообщения, возможно подключить Бота. ## Подключение ### 1. Конфигурация на стороне VK 1. Перейти в Сообщество, руководителем которого вы являетесь. Перейти в раздел “Управление”. 2. ![управл.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-jK4wVmIQ5b/cb5caada40e6c659845a6aa98027b0b68c871a92b803ab7e95aa1dc80240a1bd399d2d74f64088ccc7996890a50acc0c2d0def1c4adbabd67de61f1b4ebd703e1317240e4416567b93de08a0ba998bf552dd0f70f6f9c599af7e34bac588a28f116a941c) 3. Перейти в раздел настроек “Работа с API”. 4. ![работа с апи.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Qz8SjiLqlw/f7c5bff86bc051d69af55305108eab96b437df4a22ddc93a9b4422180104d2a286f2c376e0780ee9604d9116b563638427cb4c192364ae5b4987238fc7547c9393a208ee70d0706bc77051ff14d83acbc473b25b91914fe6e19fbab29f14b2ac70301ef9) 5. Нажать кнопку Создать ключ. 6. ![создать ключ.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-HuOcyL0b5i/e5797d3e6ed163614d70edcc7eea605ac8a1bed7fcacb43a455c5d15e61ac37c42e177f095aa958c89e8d13230d55e4e7b67e1a515ec98f43266736bf67468d65cb133ddd68e2afe086331326e9ac2ad4929edf9a5e51f0e516d3780dc907ff12d5dcb2e) 7. Проставить галочки возле пунктов "Разрешить приложению доступ к управлению сообществом” и “Разрешить приложению доступ к сообщениям сообщества”, нажать кнопку Создать. 8. ![создать.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KtpkAJmVK5/0120a31983caf15f35c9180140cacd082715af49daa87d5f55e63d54c000d0c7e77b4eaf8aad8af5bdb7da807447f659d55f5b9849e4ab8dcf433eb6fcd63c8d8c784bf4f8bd95de9ad38b07cb24364658625d51b316e203b2f05b00d3dee3a6e89afd86) 9. Подтвердить действие с помощью двухфакторной аутентификации. 10. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-YGThUTCAbd/86ba68b135432e9ff864fe4392f216fb96f1a60eb990e86d9e0de2abc9c06c13360cc45dc62f82a8761784b6f27902dace0e567b07f8bd628fceecb0584561a7080ff7296b90c315b2efbdb4fb68b0b6007448b553460cb4d177181dfa4c43cc60b0f1b3) 11. Появившийся токен скопировать в буфер обмена. 12. ![токен вк.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-dmeebo5Yjd/d52ea79795a17f0a0f2283d905ce6f3d1da5534d1d8e0297ca79a550b5d20fc0f844932a4db6d67434eb8deb4924cbc4a86eefb460e1ed4c21d8978cb796670da700010922e52a4df07cbbeccaf1ea74ea62a30a5a08d01ed781fc20c02c7764e3755d61) ### 2. Конфигурация канала агента в Платформе Агенту необходимо создать и настроить Канал Проекта с Коннектором “VK”. 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-gqGfJpcoE_/725454ffc79bd50163bc58f34ea763ca544349ec3f0227f58e621a9b7682ea53b5bf702bc7a5b717114cdcdcd0851407cd13a0c392cbc2536b51e0dd0c4f064fa73283cbb2c8ccc67d442682fc1eb54bf569a191e514eee69dd948e885d1de5b093ba7d7) 4. Выберите VK. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Ew5qobhDfU/d535307ef852cfe78c8234f4ce34b83193a086511d83144faf2204c7bc5719a43d55bf31fcc60dc5366a86a8f16b07d14389e95ea5f3eb3613e07b977a957a22ecfea19174552ef1013db2ac8387724b6b122eef1fc3c099f6b0fa74542e24c323b049d2) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-9En1GC24zQ/b421bd43c16d797f57a4b75dd090f2a33d3369e7c1d854d398d0dd8574b68656119fd3c8ea2aa5c2525e2443b84441d4daab3a0293486d52d74acda854c0fdb03854e596141d2559663ed4ebc7ca7cf9973ffb8ade77cfd58e815240c7f4f988de10781a) 7. Вставьте скопированный ранее токен в поле VK token.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ckkqSrhWio/eecb5c5fc67d6d3089fe82ac089afebd092565002f81ceba3a7b003b6143f8afc6ff7ea19c086a67ad4359dad5d24ac9b5336a6d9623c9669bc4f381b56dbb1b86aaaff8e520682e256be0336aadb1f832e9c2ad4cfaac6725aa1c33ef0a3dbc82093436) 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-4HnDA0Knpd/84d412b6ac2d7a1f1d8161384a9894b04f701141cfcfcd2757f1ed221b79f801fd9a52d4634d56694b09d48f97eeced95b1926bec6ae90983640a5888d99bd7585defb6e8c0ded02092a7774df83580dbeeaeb3a11d8888ae789aa4666156c7e7c731bc6) 10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-upAF5ZHdu3/93429fb6164a30330ce42da147f4ad7590bf27d1b29478e0624b41a48cfa902f5280c34e744e4a350b97e0f75c78bef79bce7519dbb1e7f70f0e1ec9c746e87285e14b0c65682819571cc8c71f195778073bb11bd876ca65d4f3b20b432fcb6a211c4443) 11. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-SobKaFBIsS/b21e4525cbf72e9ade9cd98dae991e24169ab27684211642b9e3a7f882bfeda1b9f588dcbc57031a24dbb9a615e79e9830b7ff4c0e07690fec352d05d5092fd6a53e6fc3d6ffc408b3a7da1ec5d56f8020f9c4adb593572c9ad5aef20a4f055a4f1e108a) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-PMlxtcN-M0/486ed2db1883aaaef9cd114293b4e3251714d3fd74520cddcdfee5c688e9a9f4cfa737e7e7bc5ebdd1fd0f0b1c1c4368f7e0ee21d1488fedd9da8e5ee6b8c03d38cd48c78177774ce84646ec51a3bd2c22818fecfdd87eb018be33e53959fdc420ad148c) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-kPWuq5EgKg/ea7ac30942e0762d51eadc1fe15e6defa3e6d37f2e7268275d4595e52390b89a6e6583cf3dc2c9fe527fce0b87c1a4fa149f7e488347527f14cb312b794fc3cfab34b38165c473ea689acc991430b21d31559c1be9ba6c0b69f3279defd0672ccf83e462) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--WdeTHZdaD/c28f895437bd0e3b7dd9576a23530dbc83c9d43dacbc7309a207d566b2bed12744e339ab114da8cdca74ea02f564e4f1a4f1f64ac0e5524e52828b8e556dab6696cdf9b41afd4748fb093bb1ae3b5afda7ca936617763abb9f48cab3d57951ee4b5543f5) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-OSz5m-yYUx/9371d07083a5409b31f6d38a31149782435d0ec84f45d185f86b1fb7d19109eb66850e8878a03306a3bb8ca5a30c8a91e01cd33ed1e9b652f7bbd96f128523fa7aa0b1e06ec21636e8ee54e869ad6fd9717fc6d8e31ca19c17aa92420edfc716a31cd773) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-FSk9B2egCY/9c30b6dd9de80af158e47bb5c8bf2cc3396d75245f7c346410effdefc5d8b8208380fa4b8283b3404eb2d06ef7ad0912cba4e601ba778277513c5bd75d81d60fb4284efca749d7fa574cddb4c50b066a5714dfaea140dd9f1d78dd722ff5c65255703b3b) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-g9koj_j_En/ed8dbd5612dfc9b86d972e9897761ffadc9a21c3121a2c820a8446f59c921fb67fd45c3424cb7fdfbd6c4e8e96ea5a4691c814736d6c743d011d1fe20e0e41c65d4a6530d668bc13c7b700abc9a898e659217706a1365c2280f0e9474983ac8304292e33) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ate5uwtrVi/1fa115a886192588cc2ce53c7c2f6b080a59671e77ce08d776be9763e20718811b9f8854f50e6875d43b8850e7ec44f83a141194c88461974b92a685f826289a2ba6493d79c44e52c22307b18fd269cd0243382c02e2c5893eb851fe8af144124c08f556) ## Общение Взаимодействие с VK происходит по асинхронному методу с использованием [API версии 5.131](https://dev.vk.com/reference/versions#5.131). Общение происходит в Сообществах VK, куда подключается Бот. Пользователи VK могут писать в личные сообщения Сообщества, нажав кнопку Написать сообщение, и получать ответы от Бота.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-WmRr1j32kW/a328c355c3354b8cfba30d4132d1565c15e2918f8d0b32fcdc48b8654c23fa349129270f04b64d72c1efbeaea9af0cf40c22cc20392c827f7fa6ef89acddc3b38a5d88d5feb0d5e22959be943a05db1b0db1d3d7216aeb3e701fe3a2a210d9a1ad2b71f8) | Переменная | Конечный канал | Переменная в запросе из канала | Примечания | | --------------------------- | -------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | channel\_visitor\_id | VK | from\_id | id пользователя VK | | channel\_conversation\_id | VK | from\_id | id пользователя VK | | channel\_visitor\_firstname | VK | first\_name | Можно получить при помощи [ER](https://dev.vk.com/method/users.get) ,указав user\_ids и access\_token | | channel\_visitor\_lastname | VK | last\_name | Можно получить при помощи [ER](https://dev.vk.com/method/users.get) ,указав user\_ids и access\_token | | channel\_visitor\_account | VK | Нет | | | channel\_visitor\_phone | VK | Нет | | | channel\_visitor\_email | VK | Нет | | | channel\_visitor\_source | VK | Не приходит в запросе, но создается в Контекст Чата | id сообщества VK, куда подключен Агент, в запросе не приходит | | channel\_visitor\_auth | VK | Нет | | | channel\_visitor\_location | VK | Нет | | | channel\_message\_id | VK | Нет | | | channel\_message\_recipient | VK | Нет | | | Функционал общения | Конечный канал | Доступность в канале | Примечания | | ------------------------------------------------------------------------------ | -------------- | -------------------- | ---------------------------------------------------------- | | channel\_chat\_id | VK | Нет | | | Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | VK | Да | | | Кнопки | VK | Да | Нажатие на кнопку приходит Агенту как текст лейбла кнопки. | | Перевод на оператора | VK | Нет | В VK нет такого функционала | | Передача файлов в виде файлов от Агента (Attachment) | VK | Нет | | | Передача файлов в виде ссылок от Агента (Attachment) | VK | Да | | | Получение файла от Собеседника в сценарий | VK | Да | Формат: тип\|тип\|id файла\|ссылка на файл | | Получение геолокации от собеседника в сценарии | VK | Да | Формат: location:53.952693\|27.781444 | | Доставка сообщений более 1000 символов от Агента до Собеседника | VK | Да | | | Получить ссылку на источник лида | VK | Нет | | | Использование маркдауна | VK | Нет | | | Рассылки с помощью Notification | VK | Нет | |