Skip to content
Gallery
Docs
История изменений
История релизов
НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ
ПЕРЕД СОЗДАНИЕМ АГЕНТА
КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА
СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ
ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА
РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ
ЭКСПЛУАТАЦИЯ АГЕНТА
АНАЛИТИКА ОБЩЕНИЯ АГЕНТА
РЕАЛИЗАЦИЯ КЕЙСОВ
ДЛЯ РАЗРАБОТЧИКОВ
ПРИЛОЖЕНИЯ
New Change Chat Mode
Share
Explore
Вывод Агента в мессенджеры

icon picker
VK

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

Подключение

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

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

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

⁠
@Агент
⁠
у необходимо создать и настроить
@Канал Агента
⁠
с
@Коннектор
⁠
ом “VK”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
⁠
а.
⁠
image.png
⁠
⁠
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Messaging.
Нажмите кнопку Add another channel ​
image.png
⁠
⁠
Интеграция с VK происходит через
@Коннектор
⁠
с названием “VK”, установите его в поле Channel.
⁠
image.png
⁠
⁠
По необходимости пропишите заголовок для данного
@Канал Агента
⁠
в поле Title. ​
image.png
⁠
⁠
После выбора вам станет доступно для записи поле Token, в которое нужно вставить
предварительно скопированный токен
⁠
.
⁠
image.png
⁠
⁠
Активируйте канал переключением тумблера для того, чтобы
@Агент
⁠
начал отвечать в нем.
⁠
ктивация.png
⁠
⁠
Если
@Агент
⁠
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
⁠
а, после чего повторить попытку активации
@Канал Агента
⁠
.
⁠
image.png
⁠
⁠
После активации
@Канал Агента
⁠
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
⁠
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
⁠
image.png
⁠
⁠
”Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.
⁠
image.png
⁠
⁠
Сохраните
@Канал Агента
⁠
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

Общение

Взаимодействие с VK происходит по асинхронному методу с использованием
API версии 5.131
⁠
.
@Общение
⁠
происходит в Сообществах VK, куда подключается
@Бот
⁠
. Пользователи VK могут писать в личные сообщения Сообщества, нажав кнопку Написать сообщение, и получать ответы от
@Бот
⁠
а.
⁠
image.png
⁠
⁠
Маппинг Канальных переменных из VK
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
Особенности
1
channel_visitor_id
VK
from_id
id пользователя VK
2
channel_conversation_id
VK
from_id
id пользователя VK
3
channel_visitor_firstname
VK
first_name
Можно получить при помощи
ER
⁠
,указав user_ids и access_token
4
channel_visitor_lastname
VK
last_name
Можно получить при помощи
ER
⁠
,указав user_ids и access_token
5
channel_visitor_account
VK
Нет
​
6
channel_visitor_phone
VK
Нет
​
7
channel_visitor_email
VK
Нет
​
8
channel_visitor_source
VK
Не приходит в запросе, но создается в
@Контекст Чата
⁠
id сообщества VK, куда подключен
@Агент
⁠
, в запросе не приходит
9
channel_visitor_auth
VK
Нет
​
10
channel_visitor_location
VK
Нет
​
11
channel_message_id
VK
Нет
​
12
channel_message_recipient
VK
Нет
​
13
channel_reply_to
VK
нет
​
There are no rows in this table
⁠
Возможности общения в VK
Функционал
Конечный канал
Наличие в канале
Описание
1
channel_chat_id
VK
Нет
​
2
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
VK
Да
​
3
Кнопки
VK
Да
Нажатие на кнопку приходит Агенту как текст лейбла кнопки.
4
Перевод на оператора
VK
Нет
В VK нет такого функционала
5
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
VK
Нет
​
6
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
VK
Да
​
7
Получение файла от Собеседника в сценарий
VK
Да
Формат: тип|тип|id файла|ссылка на файл
8
Получение геолокации от собеседника в сценарии
VK
Да
Формат: location:53.952693|27.781444
9
Доставка сообщений более 1000 символов от Агента до Собеседника
VK
Да
​
10
Получить ссылку на источник лида
VK
Нет
​
11
Использование маркдауна
VK
Нет
​
12
Рассылки с помощью Notification
VK
Нет
​
There are no rows in this table
⁠

Подключение
1. Конфигурация на стороне VK
2. Конфигурация канала агента в Платформе
Общение
Маппинг Канальных переменных из VK
Возможности общения в VK
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.