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