Page Comparison

Создание канала в AutoFAQ

Для создания каналов необходимо зайти под пользователем с ролью Администратор и перейти в Настройки → Каналы, нажать кнопку “Новый канал”.

Страница созданного канала будет выглядеть одинаково для обоих типов:

Image Added

Вам нужно заполнить следующие обязательные поля:

• Группы: выбрать те группы нашей системы, в которые нужно подключить канал

• Параметры для подключения:

  • ownerId

  • shortGroupName

  • groupAccessToken

Замечание: если Вы подключаете только один канал, соответственно только для него и нужно заполнить параметры подключения. Если вы подключаете два канала (и API, и Direct) для одной группы/сообщества ВКонтакте, то настройки подключения для обоих каналов будут одинаковыми (т.е. при заполнении вы копируете их сразу в оба канала).

Заполнение параметров подключения и настройка сообщества/группы ВКонтакте

Подключить к нашей системе можно группу или сообщество ВКонтакте. Для этих групп и сообществ Вам необходимо быть администратором в ВК.

1.Включить файлы в настройках группы ВК

Для группы в настройках нужно включить необходимые типы файлов (Фотографии, Видео, Аудиозаписи, Файлы), чтобы оператор мог отправлять их от имени этой группы. Зайти в Управление → Настройки → Разделы → Документы → Ограниченные Включить нужные( перевести в Открытые) → Сохранить.

Image Removed

Если этого не сделать, то пользователь будет получать только текст сообщения, без отправленного оператором файла. Для сообщества дополнительно включать ничего не надо.

Image Added

2.

Включить личные сообщения для группы/сообщества ВК

Страница группы/сообщества - Управление - Сообщения и “Сообщения сообщества” = Включены:

3.

Начиная с версии 3.7.0 можно добавить отдельно ВКонтакте API и ВКонтакте Direct. Здесь мы рассматриваем подключение сразу обоих каналов одновременно.

После каждого изменения поля в настройках канала ВКонтакте API необходимо нажимать кнопку "Сохранить", чтобы не потерять введенные данные.

Интерфейс AutoFAQ "Настройки" - "Каналы" -  "ВКонтакте API"

Image Removed

Замечание 1: На данный момент в приложении ВК есть ограничение на время жизни токена userAccessToken ( 1 день), поэтому мы используем standaloneAccessToken, который не протухает. Но чтобы это работало, его надо получать на отдельно поднятой машине и выполнять пункт 5 на отдельной машине через удаленный рабочий стол.

1.Создаем два канала двух разных типов - ВКонтакте API и ВКонтакте Direct. Все дальнейшие настройки копируем в оба эти канала.

Image Removed

2. Вам необходимо быть администратором группы ВК, которую вы хотите подключить.

Заполнить параметры подключения каналов в AutoFAQ

Название параметра подключение канала	Способ получения параметра из ВК
shortGroupName	Скопировать из настроек группы в ВК адрес страницы (Управление - Настройки - Основная информация), он указан в виде https://vk.com/ваш_адрес. Вставить его в поле shortGroupName. Image Added
groupAccessToken	В настройках группы ВК в разделе Управление -> Работа с API -> "Ключи доступа"

Image Removed

Image Removed

Сообщения: Входящее сообщение

Фотографии: Новый комментарий

Видеозаписи: Новый комментарий

, Действие с сообщением, Редактирование сообщения Комментарии на стене: Добавление

Обсуждения: Добавление

Товары: Новый комментарий

5. Подключиться к удаленному рабочему столу и выполнить следующий шаг в нем в браузере в режиме инкогнито.

Параметры подключения к удаленному рабочему столу:

• хост(адрес): chat.autofaq.ai

• пользователь = пароль = alpine

Открыть AutoFAQ - "Настройки" - "Каналы" -  "ВКонтакте API", нажать правой кнопкой мыши на "standaloneAppTokenLink" и открыть в новой вкладке, зайти в ВК, а затем скопировать значение token-а из адресной строки и вставить в поле standaloneAccessToken настроек AutoFAQ.
После выполнения этого действия сохранить настройки в AutoFAQ, закрыть браузер и выйти из удаленного рабочего стола. Далее продолжаем настраивать на вашем обычном компьютере.

6. Скопировать из настроек группы в ВК адрес страницы (Управление - Настройки - Основная информация), он указан в виде https://vk.com/ваш_адрес. Вставить его в поле shortGroupName настроек AutoFAQ.

Image Removed

, Редактирование, Удаление, Восстановление Image Added
ownerId	Перейти по ссылке https://dev.vk.com/method/utils.resolveScreenName в раздел "Пример запроса". В поле access_token вставить groupAccessToken, а в поле screen_name вставить

Image Removed

Image Added Поле object_id скопировать и вставить в поле ownerId настроек AutoFAQ.

4.

4.Включить возможности ботов в настройках группы/сообщества ВК

Для работы кнопок в личных сообщениях необходимо включить бота в настройках страницы/группы. Для этого перейти в Управление - Сообщения - Настройки для бота и в Возможности ботов выбрать “Включены”:

Image Added

Подключение только ВКонтакте API или только ВКонтакте Direct

Подключение только одного из каналов отличается в нескольких шагах предыдущей инструкции.

Если у вас уже что-то было подключено и сервер создан, то в ВК нужно нажать на кнопку “Добавить сервер” и далее выполнять пункт 31-4 2 для нового сервера.

31.В настройках группы ВК в разделе "Управление -> Работа с API -> Callback API" выбрать версию API 5.103 и указать адрес:

подключаем только API (комментарии)	https://chat.autofaq.ai/vk-adapter/api/vk/webhooks?api=<ID_channel_2>&code=<строка_которую_должен_вернуть_сервер>
подключаем только Direct (личные сообщения)	https://chat.autofaq.ai/vk-adapter/api/vk/webhooks?direct=<ID_channel_1>&code=<строка_которую_должен_вернуть_сервер>

где

вместо chat.autofaq.ai необходимо указать адрес вашего сервиса,

<ID_channel_1> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК Direct”,

<ID_channel_2> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК API”,

<строка_которую_должен_вернуть_сервер> так и называется из раздела группы ВК "Управление" -> "Работа с API" -> "Callback API".

42.Далее выбираем типы событий в зависимости от типа подключаемого канала.

подключаем только API (комментарии)

Фотографии: Новый комментарий

Видеозаписи: Новый комментарий

Комментарии на стене: Добавление

Обсуждения: Добавление

Товары: Новый комментарий

, Редактирование, Удаление, Восстановление
подключаем только Direct (личные сообщения)	Сообщения

-

: Входящее сообщение, Исходящее сообщение

Обмен файлами

В версии приложения 3.6.0 поддерживается только обмен картинками. Данная функциональность доступна для:

Что видит пользователь

Что видит оператор

Личные сообщения в группе

Image Removed

Image Removed

Комментарии на стене группы, комментарии к фото, видео

Image Removed

Image Removed

Комментарии к товару, комментарии к обсуждениям

Image Removed

Image Removed

Обновление 3.7.4

Теперь в ответе пользователю есть обращение к нему, чтобы он получил уведомление от социальной сети.

ВК Комментарии для разных типов записей

Если нужно, чтобы система обрабатывала комментарии, которые пользователи оставили под:

• фотографиями сообщества/группы

• видеозаписями сообщества/группы

• обсуждениями сообщества/группы

• товарами сообщества/группы

тогда нужно включить соответствующие галочки для интересующих типов событий в "Управление" -> "Работа с API" -> "Callback API" -> "Типы событий":

Image Added

Помимо этого, для настройки канала в AutoFAQ требуется дополнительно заполнить поле standaloneAccessToken. Для этого нужно (1) перейти по ссылке standaloneAppTokenLink и из адресной строки скопировать значение access_token. Например, вся ссылка может выглядеть вот так:

https://oauth.vk.com/blank.html#access_token=vk1.a.1vC9Gv....31f1GqQtyA&expires_in=0&user_id=********

Нужно скопировать всё после access_token= и до &expires_in . Затем в настройках канала нажать (2) кнопку “Установить новый токен” и в окошко вставить скопированное значение. Сохранить изменения.

Image Added

Текущие ограничения

На данный момент ВКонтакте не поддерживает отправку файлов в комментарии на стену для сообществ. Если у Вас сообщество и Вы хотите обмениваться файлами в комментариях на стене/товаров и других местах, то Вам нужно перевести сообщество в группу.

В правом меню выбрать Еще → Перевести в группу → Подтвердить перевод.