Начиная с версии 3.6.0, система поддерживает группу из Вконтакте как новый канал. Реагировать она может на следующие события:
комментарий под постом на стене группы
комментарий под фото группы
комментарий под видеозаписью группы
комментарий под обсуждением группы
комментарий под товаром группы
прямое (личное) сообщение, отправленное в группу (если в настройках группы включены личные сообщения)
Выполните ПОДРЯД три следующих инструкции.
1. Перевод страницы в группу
Для того, чтобы работала функциональность обмена файлами между системой и пользователем, страница (сообщество) ВКонтакте должна быть переведена в Группу. В правом меню выбрать Еще → Перевести в группу → Подтвердить перевод.
Затем в настройках нужно включить Документы, чтобы оператор мог отправлять файлы от имени этой группы. Зайти в Управление → Настройки → Разделы → Документы → Ограниченные → Сохранить.
2. Как включить личные сообщения для группы
Страница группы - Управление - Сообщения
3. Подключение канала, если подключаем ВКонтакте API и ВКонтакте Direct.
Начиная с версии 3.7.0 можно добавить отдельно ВКонтакте API и ВКонтакте Direct.
После каждого изменения поля в настройках канала ВКонтакте API необходимо нажимать кнопку "Сохранить", чтобы не потерять введенные данные.
Интерфейс AutoFAQ "Настройки" - "Каналы" - "ВКонтакте API"
Замечание 1: На данный момент в приложении ВК есть ограничение на время жизни токена userAccessToken ( 1 день), поэтому мы используем standaloneAccessToken, который не протухает. Но чтобы это работало, его надо получать на отдельно поднятой машине и выполнять пункты 6,7 на отдельной машине через удаленный рабочий стол.
1. Вам необходимо быть администратором группы ВК, которую вы хотите подключить.
В настройках группы в разделе Управление -> Работа с API -> "Ключи доступа" создаете ключ доступа со следующими правами "сообщения сообщества, фотографии, документы, стена".
2. Создаем два канала двух разных типов - ВКонтакте API и ВКонтакте Direct. Все дальнейшие настройки копируем в оба эти канала.
3. В AutoFAQ в настройках каналов ВКонтакте API/Direct добавить этот ключ в поле groupAccessToken.
4. В настройках группы ВК в разделе "Управление -> Работа с API -> Callback API" выбрать версию API 5.103 и указать адрес:
https://test-chat.autofaq.ai/vk-adapter/api/vk/webhooks/?direct=<ID_channel_1>&api=<ID_channel_2>&code=<строка_которую_должен_вернуть_сервер>
где <ID_channel_1> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК Direct”,
<ID_channel_2> = ID из адресной строки в AutoFAQ "Настройки" - “Каналы” - “ваш ВК API”,
<строка_которую_должен_вернуть_сервер> так и называется из раздела группы ВК "Управление" -> "Работа с API" -> "Callback API".
Нажать кнопку "Подтвердить" - должна появиться зеленая галочка, это значит всё ок.
5. Необходимо в "Управление" -> "Работа с 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 поддерживается только обмен картинками. Данная функциональность доступна для:
Что видит пользователь | Что видит оператор | |
|---|---|---|
Личные сообщения в группе |  |  |
Комментарии на стене группы, комментарии к фото, видео |  |  |
Комментарии к товару, комментарии к обсуждениям |  |  |