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