Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

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

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

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

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

  • прямое (личное) сообщение, отправленное

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

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

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

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

    нужен обмен файлами)

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

    Затем в настройках нужно включить необходимые типы файлов (Фотографии, Видео, Аудиозаписи, Файлы), чтобы оператор мог отправлять их от имени этой группы.

    Зайти в Управление → Настройки → Разделы → Включить нужные → Сохранить.

    Если этого не сделать пользователь будет получать только текст сообщения, без отправленного оператором файла.

    Image RemovedImage Added

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

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

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

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

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

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

    Image Removed

    Создаем два канала двух разных типов - ВКонтакте 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".

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

    <ID_channel>

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

    • Сообщения: Входящее сообщение

    • Комментарии на стене: Добавление, Редактирование, Удаление, Восстановление

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

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

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

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


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

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

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

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

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

    3.В настройках группы ВК в разделе "Управление -> Работа с 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=<строка_которую_должен_вернуть_сервер>

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

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

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

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

    подключаем только API (комментарии)

    • Фотографии: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление

    • Видеозаписи: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление

    • Комментарии на стене: Добавление, Редактирование, Удаление, ВосстановлениеОбсуждения: Добавление, Редактирование, Удаление, ВосстановлениеТовары: Новый комментарий, Редактирование комментария, Удаление комментария, Восстановление

    подключаем только Direct (личные сообщения)

    • Сообщения: Входящее сообщение, Исходящее сообщение, Редактирование сообщения

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

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

    Что видит пользователь

    Что видит оператор

    Личные
    • сообщения

    в группеImage Removed

    Image Removed

    Комментарии на стене группы, комментарии к фото, видео

    Image Removed

    Image Removed

    Комментарии к товару, комментарии к обсуждениям

    Image Removed

    Image Removed

    Обновление 3.7.4

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

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