Вывод Агента в VK
В данной статье описан вывод Агента напрямую в VK и возможности общения Агента в VK.
VK — социальная сеть, имеющая веб-версию, версию для мобильных устройств и мобильное приложение. Включает в себя функционал мессенджера и публичных сообществ, куда в качестве оператора, отвечающего на сообщения, возможно подключить Бота.
- 1.Перейдите в Сообщество, руководителем которого вы являетесь. Перейдите в раздел “Управление”.
- 2.Перейдите в раздел настроек “Работа с API”.
- 3.Нажмите кнопку Создать ключ.
- 4.Проставьте галочки возле пунктов "Разрешить приложению доступ к управлению сообществом” и “Разрешить приложению доступ к сообщениям сообщества”, нажмите кнопку Создать.
- 5.Подтвердите действие с помощью двухфакторной аутентификации.
- 6.Появившийся токен скопируйте в буфер обмена.
Агенту необходимо создать и настроить Канал Агента с коннектором VK.
- 1.Войдите в меню редактирования (Edit) настроек вашего Агента.
- 2.В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
- выберите тип канала Messaging
- Нажмите кнопку Add another channel.
- 3.Интеграция с VK происходит через Коннектор с названием “VK”, установите его в поле Channel.
- 4.По необходимости пропишите заголовок для данного канала в поле Title.
- 1.Заголовки разных каналов агента могут совпа дать.
- 5.После выбора вам станет доступно для записи поле Token, в которое нужно вставить предварительно скопированный токен.
- 6.Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем после сохранения.
- 1.Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канала Агента.
- 7.После активации Канал Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы):
"Can’t reach channel"— выводится в случае, если сервер не отвечает по указанному URL
- 8.Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.
Взаимодействие с VK происходит по асинхронному методу с использованием API версии 5.131. Общение происходит в Сообществах VK, куда подключается Бот. Пользователи VK могут писать в личные сообщения Сообщества, нажав кнопку Написать сообщение, и получать ответы от Бота.
Канальная переменная | Переменная в теле входящего запроса из канала | Особенности |
|---|---|---|
channel_visitor_id | from_id | id пользователя VK |
channel_conversation_id | from_id | id пользователя VK |
channel_visitor_firstname | first_name | Можно получить при помощи External Request, указав user_ids и access_token. Информация о методе: https://dev.vk.com/method/users.get |
channel_visitor_lastname | last_name | Можно получить при помощи External Request, указав user_ids и access_token. Информация о методе: https://dev.vk.com/method/users.get |
channel_visitor_account | нет | |
channel_visitor_phone | нет | |
channel_visitor_email | нет | |
channel_visitor_source | не приходит в запросе, но создается в Контексте Чата | id сообщества VK, куда подключен Агент, в запросе не приходит |
channel_visitor_auth | нет | |
channel_visitor_location | нет | |
channel_message_id | нет | |
channel_message_recipient | нет | |
Функционал | Наличие в к анале | Описание |
|---|---|---|
channel_chat_id | Нет | |
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | Да | |
Кнопки | Да | Нажатие на кнопку приходит Агенту как текст лейбла кнопки. |
Перевод на оператора | Нет | В VK нет такого функционала |
Передача файлов в виде файлов от Агента (Attachment_suBXn ) | Нет | |
Передача файлов в виде ссылок от Агента (Attachment_suBXn ) | Да | |
Получение файла от Собеседника в сценарий | Да | Формат: тип|тип|id файла|ссылка на файл |
Получение геолокации от собеседника в сценарии | Да | Формат: location:53.952693|27.781444 |
Доставка сообщений более 1000 символов от Агента до Собеседника | Да | |
Получить ссылку на источник лида | Н ет | |
Использование маркдауна | Нет | |