VK

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

Подключение

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

1. Перейти в Сообщество, руководителем которого вы являетесь. Перейти в раздел “Управление”.

2. 

3. Перейти в раздел настроек “Работа с API”.

4. 

5. Нажать кнопку Создать ключ.

6. 

7. Проставить галочки возле пунктов "Разрешить приложению доступ к управлению сообществом” и “Разрешить приложению доступ к сообщениям сообщества”, нажать кнопку Создать.

8. 

9. Подтвердить действие с помощью двухфакторной аутентификации.

10. 

11. Появившийся токен скопировать в буфер обмена.

12. 

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

Агенту необходимо создать и настроить Канал Проекта с Коннектором “VK”.

1. Кликните по кнопке настроек Агента.
2. Нажмите кнопку Add channel.
3. Откроется панель выбора Конечный канал.
4. Выберите VK.
5. Откроется панель создания Канал Проекта.
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
7. Вставьте скопированный ранее токен в поле VK token.
8. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.
9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
11. 1. Канал Проекта будет сохранен и активирован, если:
    2. 1. Агент обучен;
       2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
3. 1. Изменения будут применены, если:

   2. 1. Агент обучен;
      2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения не будут применены, если одно или больше условий не будут выполнены.

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:
   2. 1. Агент обучен;
      2. токен в поле VK token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Взаимодействие с VK происходит по асинхронному методу с использованием API версии 5.131. Общение происходит в Сообществах VK, куда подключается Бот. Пользователи VK могут писать в личные сообщения Сообщества, нажав кнопку Написать сообщение, и получать ответы от Бота.

Переменная	Конечный канал	Переменная в запросе из канала	Примечания
channel_visitor_id	VK	from_id	id пользователя VK
channel_conversation_id	VK	from_id	id пользователя VK
channel_visitor_firstname	VK	first_name	Можно получить при помощи ER ,указав user_ids и access_token
channel_visitor_lastname	VK	last_name	Можно получить при помощи ER ,указав user_ids и access_token
channel_visitor_account	VK	Нет
channel_visitor_phone	VK	Нет
channel_visitor_email	VK	Нет
channel_visitor_source	VK	Не приходит в запросе, но создается в Контекст Чата	id сообщества VK, куда подключен Агент, в запросе не приходит
channel_visitor_auth	VK	Нет
channel_visitor_location	VK	Нет
channel_message_id	VK	Нет
channel_message_recipient	VK	Нет

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