chatme.ai
Search
⌃K

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

В данной статье описан вывод Агента напрямую в VK и возможности общения Агента в VK.
VK — социальная сеть, имеющая веб-версию, версию для мобильных устройств и мобильное приложение. Включает в себя функционал мессенджера и публичных сообществ, куда в качестве оператора, отвечающего на сообщения, возможно подключить Бота.

Подключение

Конфигурация на стороне VK

  1. 1.
    Перейдите в Сообщество, руководителем которого вы являетесь. Перейдите в раздел “Управление”.
    управл.png
  2. 2.
    Перейдите в раздел настроек “Работа с API”.
    работа с апи.png
  3. 3.
    Нажмите кнопку Создать ключ.
    создать ключ.png
  4. 4.
    Проставьте галочки возле пунктов "Разрешить приложению доступ к управлению сообществом” и “Разрешить приложению доступ к сообщениям сообщества”, нажмите кнопку Создать.
    создать.png
  5. 5.
    Подтвердите действие с помощью двухфакторной аутентификации.
    image.png
  6. 6.
    Появившийся токен скопируйте в буфер обмена.
    токен вк.png

Конфигурация канала Агента в Платформе

Агенту необходимо создать и настроить Канал Агента с коннектором VK.
  1. 1.
    Войдите в меню редактирования (Edit) настроек вашего Агента.
  2. 2.
    В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
    • выберите тип канала Messaging
    • Нажмите кнопку Add another channel.
      messaging.png
  3. 3.
    Интеграция с VK происходит через Коннектор с названием “VK”, установите его в поле Channel.
  4. 4.
    По необходимости пропишите заголовок для данного канала в поле Title.
    1. 1.
      Заголовки разных каналов агента могут совпадать.
  5. 5.
    После выбора вам станет доступно для записи поле Token, в которое нужно вставить предварительно скопированный токен.
  6. 6.
    Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем после сохранения.
    1. 1.
      Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канала Агента.
      image.png
  7. 7.
    После активации Канал Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы): "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
  8. 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 символов от Агента до Собеседника
Да
Получить ссылку на источник лида
Нет
Использование маркдауна
Нет