Начиная с версии 3.6.0, система поддерживает группу из Вконтакте как новый канал. Реагировать она может на следующие события:
комментарий под постом на стене группы
комментарий под фото группы
комментарий под видеозаписью группы
комментарий под обсуждением группы
комментарий под товаром группы
прямое (личное) сообщение, отправленное в группу (если в настройках группы включены личные сообщения)
Выполните ПОДРЯД три следующих инструкции.
1. Перевод страницы в группу
Для того, чтобы работала функциональность обмена файлами между системой и пользователем, страница (сообщество) ВКонтакте должна быть переведена в Группу. В правом меню выбрать Еще → Перевести в группу → Подтвердить перевод.
Затем в настройках нужно включить Документы, чтобы оператор мог отправлять файлыTable of Contents |
---|
Создание канала в AutoFAQ
Для создания каналов необходимо зайти под пользователем с ролью Администратор и перейти в Настройки → Каналы, нажать кнопку “Новый канал”.
укажите название для создаваемого канала
выберите один из двух типов канала для ВКонтакте:
ВКонтакте API - для обработки поступающих сообщений со стены сообщества/группы
ВКонтакте Direct - для обработки поступающих личных сообщений в сообщество/группу
Страница созданного канала будет выглядеть одинаково для обоих типов:
Вам нужно заполнить следующие обязательные поля:
Группы: выбрать те группы нашей системы, в которые нужно подключить канал
Параметры для подключения:
ownerId
shortGroupName
groupAccessToken
Замечание: если Вы подключаете только один канал, соответственно только для него и нужно заполнить параметры подключения. Если вы подключаете два канала (и API, и Direct) для одной группы/сообщества ВКонтакте, то настройки подключения для обоих каналов будут одинаковыми (т.е. при заполнении вы копируете их сразу в оба канала).
Заполнение параметров подключения и настройка сообщества/группы ВКонтакте
Подключить к нашей системе можно группу или сообщество ВКонтакте. Для этих групп и сообществ Вам необходимо быть администратором в ВК.
1.Включить файлы в настройках группы ВК
Для группы в настройках нужно включить необходимые типы файлов (Фотографии, Видео, Аудиозаписи, Файлы), чтобы оператор мог отправлять их от имени этой группы. Зайти в Управление → Настройки → Разделы → Документы → Ограниченные Включить нужные( перевести в Открытые) → Сохранить.
Если этого не сделать, то пользователь будет получать только текст сообщения, без отправленного оператором файла. Для сообщества дополнительно включать ничего не надо.
2.
Как включитьВключить личные сообщения для группы/сообщества ВК
Страница группы/сообщества - Управление - Сообщения и “Сообщения сообщества” = Включены:
3.
Подключение канала, если подключаем ВКонтакте API и ВКонтакте Direct.Начиная с версии 3.7.0 можно добавить отдельно ВКонтакте API и ВКонтакте Direct.
После каждого изменения поля в настройках канала ВКонтакте API необходимо нажимать кнопку "Сохранить", чтобы не потерять введенные данные.
Интерфейс AutoFAQ "Настройки" - "Каналы" - "ВКонтакте API"
Замечание 1: На данный момент в приложении ВК есть ограничение на время жизни токена userAccessToken ( 1 день), поэтому мы используем standaloneAccessToken, который не протухает. Но чтобы это работало, его надо получать на отдельно поднятой машине и выполнять пункты 6,7 на отдельной машине через удаленный рабочий стол.
1. Вам необходимо быть администратором группы ВК, которую вы хотите подключить.В настройках группы
Заполнить параметры подключения каналов в AutoFAQ
Название параметра подключение канала | Способ получения параметра из ВК |
shortGroupName | Скопировать из настроек группы в ВК адрес страницы (Управление - Настройки - Основная информация), он указан в виде https://vk.com/ваш_адрес. Вставить его в поле shortGroupName. |
groupAccessToken |
|
|
2. Создаем два канала двух разных типов - ВКонтакте API и ВКонтакте Direct. Все дальнейшие настройки копируем в оба эти канала.
3. В AutoFAQ в настройках каналов ВКонтакте API/Direct добавить этот ключ в
|
2. Сделать дополнительные настройки в ВК. В настройках группы ВК в разделе "Управление -> Работа с API -> Callback API" выбрать версию API 5.103 и указать адрес: |
?direct=<ID_channel_1>&api=<ID_channel_2>&code=<строка_которую_должен_вернуть_сервер> где вместо chat.autofaq.ai необходимо указать адрес вашего сервиса, <ID_channel_1> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК Direct”, <ID_channel_2> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК API”, <строка_которую_должен_вернуть_сервер> так и называется из раздела группы ВК "Управление" -> "Работа с API" -> "Callback API". Нажать кнопку "Подтвердить" - должна появиться зеленая галочка, это значит всё ок. |
Перейти в "Управление" -> "Работа с API" -> "Callback API" -> "Типы событий" и включить следующие события: |
|
- Фотографии: Новый комментарий
- Видеозаписи: Новый комментарий
-
|
- Обсуждения: Добавление
- Товары: Новый комментарий
6. Вернуться в AutoFAQ - "Настройки" - "Каналы" - "ВКонтакте API", нажать на "standaloneAppTokenLink", зайти в ВК (если потребуется), а затем скопировать token из адресной строки и вставить в поле standaloneAccessToken настроек AutoFAQ.
*: Если вы подключаете группу в приложение, которое стоит в облаке, то выполнять пункт 6 на машине через удаленный рабочий стол.
Тестовый стенд:
хост chat.autofaq.ai
пользователь = пароль = alpine
Там открыть браузер, зайти в приложение на стенд в режиме инкогнито и выполнить перечисленные манипуляции.7. Скопировать из настроек группы в ВК адрес страницы (Управление - Настройки - Основная информация), он указан в виде https://vk.com/ваш_адрес. Вставить его в поле shortGroupName настроек AutoFAQ.8. Перейти по ссылке https://vk.com/dev/utils.resolveScreenName в раздел "Пример запроса". В поле screen_name вставить адрес из пункта 9, затем нажать выполнить.
Поле object_id скопировать и вставить в поле ownerId настроек AutoFAQ.
9. Включить настройку “Активен” в AutoFAQ и нажать "Сохранить". Подключение настроено.Если вы использовали удаленный рабочий стол, не забудьте из него выйти.
Обмен файлами
В версии приложения 3.6.0 поддерживается только обмен картинками. Данная функциональность доступна для:
Что видит пользователь
Что видит оператор
Личные сообщения в группе
Комментарии на стене группы, комментарии к фото, видео
Комментарии к товару, комментарии к обсуждениям
| |
ownerId | Перейти по ссылке https://dev.vk.com/method/utils.resolveScreenName в раздел "Пример запроса". В поле access_token вставить groupAccessToken, а в поле screen_name вставить shortGroupName, затем нажать “Выполнить”. Поле object_id скопировать и вставить в поле ownerId настроек AutoFAQ. |
4.Включить возможности ботов в настройках группы/сообщества ВК
Для работы кнопок в личных сообщениях необходимо включить бота в настройках страницы/группы. Для этого перейти в Управление - Сообщения - Настройки для бота и в Возможности ботов выбрать “Включены”:
Подключение только ВКонтакте API или только ВКонтакте Direct
Подключение только одного из каналов отличается в нескольких шагах предыдущей инструкции.
Если у вас уже что-то было подключено и сервер создан, то в ВК нужно нажать на кнопку “Добавить сервер” и далее выполнять пункт 1-2 для нового сервера.
1.В настройках группы ВК в разделе "Управление -> Работа с 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".
2.Далее выбираем типы событий в зависимости от типа подключаемого канала.
подключаем только API (комментарии) |
|
---|---|
подключаем только Direct (личные сообщения) |
|
ВК Комментарии для разных типов записей
Если нужно, чтобы система обрабатывала комментарии, которые пользователи оставили под:
фотографиями сообщества/группы
видеозаписями сообщества/группы
обсуждениями сообщества/группы
товарами сообщества/группы
тогда нужно включить соответствующие галочки для интересующих типов событий в "Управление" -> "Работа с API" -> "Callback API" -> "Типы событий":
Помимо этого, для настройки канала в 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) кнопку “Установить новый токен” и в окошко вставить скопированное значение. Сохранить изменения.
Текущие ограничения
На данный момент ВКонтакте не поддерживает отправку файлов в комментарии на стену для сообществ. Если у Вас сообщество и Вы хотите обмениваться файлами в комментариях на стене/товаров и других местах, то Вам нужно перевести сообщество в группу.
В правом меню выбрать Еще → Перевести в группу → Подтвердить перевод.