ВКонтакте API, Direct

Начиная с версии 3.6.0, система поддерживает группу из Вконтакте как новый канал. Реагировать она может на следующие события:

• комментарий под постом на стене группы

• комментарий под фото группы

• комментарий под видеозаписью группы

• комментарий под обсуждением группы

• комментарий под товаром группы

• прямое (личное) сообщение, отправленное в группу (если в настройках группы включены личные сообщения)

Выполните ПОДРЯД три следующих инструкции.

1. Перевод страницы в группу

Для того, чтобы работала функциональность обмена файлами между системой и пользователем, страница (сообщество) ВКонтакте должна быть переведена в Группу. В правом меню выбрать Еще → Перевести в группу → Подтвердить перевод.

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

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

Страница группы - Управление - Сообщения

3. Подключение канала, если подключаем ВКонтакте API и ВКонтакте Direct.

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

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

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

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

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

2. Вам необходимо быть администратором группы ВК, которую вы хотите подключить.
В настройках группы ВК в разделе Управление -> Работа с API -> "Ключи доступа" создаете ключ доступа со следующими правами "сообщения сообщества, фотографии, документы, стена".

Скопировать его и в AutoFAQ в настройках каналов ВКонтакте API/Direct добавить этот ключ в поле groupAccessToken. 

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

• https://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".

Нажать кнопку "Подтвердить" - должна появиться зеленая галочка, это значит всё ок.

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

Сообщения: Входящее сообщение, Исходящее сообщение, Редактирование сообщения Фотографии: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление Видеозаписи: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление Комментарии на стене: Добавление, Редактирование, Удаление, Восстановление Обсуждения: Добавление, Редактирование, Удаление, Восстановление Товары: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление

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

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

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

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

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

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

7. Перейти по ссылке https://vk.com/dev/utils.resolveScreenName в раздел "Пример запроса". В поле screen_name вставить адрес из пункта 6, затем нажать “Выполнить”. 

Если в ответе пустой объект. Можно выполнить шаг по ссылке https://dev.vk.com/method/utils.resolveScreenName

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

8. Включить настройку “Активен” в AutoFAQ и нажать "Сохранить". Подключение настроено.

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

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

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

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

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

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

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

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

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

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

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

	Что видит пользователь	Что видит оператор
Личные сообщения в группе
Комментарии на стене группы, комментарии к фото, видео
Комментарии к товару, комментарии к обсуждениям

Обновление 3.7.4

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

Упоминание пользователя присутствует как в автоматических ответах, так и в ответах оператора. Но в окне оператора в открытом диалоге не отображается.