chatme.ai
Search…
Создание Агента на платформе
ДЛЯ РАЗРАБОТЧИКОВ
Вывод Агента в VK
В данной статье описан вывод Агента напрямую в VK и возможности общения Агента в VK.
VK — социальная сеть, имеющая веб-версию, версию для мобильных устройств и мобильное приложение. Включает в себя функционал мессенджера и публичных сообществ, куда в качестве оператора, отвечающего на сообщения, возможно подключить Бота.

Подключение

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

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

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

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