Вывод Агента в VK

В данной статье описан вывод Агента напрямую в 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 могут писать в личные сообщения Сообщества, нажав кнопку Написать сообщение, и получать ответы от Бота.

Маппинг Канальных переменных из 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	нет

Возможности общения в VK

Функционал	Наличие в канале	Описание
channel_chat_id	Нет
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Да
Кнопки	Да	Нажатие на кнопку приходит Агенту как текст лейбла кнопки.
Перевод на оператора	Нет	В VK нет такого функционала
Передача файлов в виде файлов от Агента (Attachment_suBXn )	Нет
Передача файлов в виде ссылок от Агента (Attachment_suBXn )	Да
Получение файла от Собеседника в сценарий	Да	Формат: тип|тип|id файла|ссылка на файл
Получение геолокации от собеседника в сценарии	Да	Формат: location:53.952693|27.781444
Доставка сообщений более 1000 символов от Агента до Собеседника	Да
Получить ссылку на источник лида	Нет
Использование маркдауна	Нет