ВКонтакте
Инструкция по настройке
Чтобы включить интеграцию на Вашем аккаунте Webim, выполните следующие шаги:
- Зайдите в Панель управления сервиса Webim и проверьте номер своей версии сервиса. Номер версии отображается слева внизу каждой страницы:
- Отправьте в службу технической поддержки запрос на активацию функции интеграции с сообществами ВКонтакте.
- После того как версия Webim обновлена, войдите в сеть ВКонтакте и откройте страницу сообщества, которое хотите связать с учётной записью Webim.
- Нажмите кнопку Управление сообществом (Manage community):
- Вам нужно использовать для входа такую учётную запись ВКонтакте, которая имеет статус Владелец, Администратор или Редактор в этом сообществе.Чтобы увидеть статус аккаунтов руководства сообществом, выберите вкладку Участники (Members), на ней Руководители (Management):
Найти статус руководителей сообществом ВКонтакте:
- Убедитесь, что в этом сообществе включен сервис сообщений. Для этого перейдите на страницу Сообщения выбранного сообщества:
- Найдите опцию Сообщения сообщества (выделена красным на иллюстрации выше). Если сообщения выключены, включите их.
- На странице настроек сообщества перейдите к разделу Работа с API. Там выберите вкладку Ключи доступа и нажмите кнопку Создать ключ:
- В этой форме выберите следующие пункты:
- Разрешить приложению доступ к сообщениям сообщества — в любом случае;
- Разрешить приложению доступ к фотографиям сообщества — если Ваша версия Webim не ниже 10.0.39, в этом случае изображения будут передаваться в ВК как фотографии. В более ранних версиях, а также при выключенном параметре они будут передаваться как ссылки;
- Разрешить приложению доступ к документам сообщества — если Ваша версия Webim не ниже 10.0.43, в этом случае файлы некоторых типов будут передаваться в ВК как документы. В более ранних версиях, а также при выключенном параметре они будут передаваться как ссылки.
Затем нажмите кнопку Создать:
- Вид и функциональность этой формы зависят от персональных настроек аккаунта и мобильного устройства. Если система предлагает выбор, то выберите удобный и доступный способ подтверждения, например, через SMS:
- Дождитесь короткого сообщения на телефон с кодом подтверждения.
- Введите его в поле Код подтверждения и нажмите кнопку Отправить код:
- На этой странице обратите внимание на появление сведений о только что созданном ключе. Выделите этот ключ доступа и скопируйте его в буфер обмена:
- Переключитесь на вкладку Callback API и выберите в поле Версия API значение 5.92:
- Не закрывая вкладки браузера с открытой страницей сообщества ВКонтакте, откройте новую вкладку браузера с Панелью управления сервиса Webim, страница Общих настроек, раздел Каналы общения:
- В блоке настроек каналов ВКонтакте нажмите кнопку Добавить сообщество. Откроется форма Добавление сообщества ВКонтакте:
- Найдите поле Название сообщества и введите там наименование, под которым этот канал будет отображаться в Личном кабинете оператора.
- Найдите поле Ключ доступа и вставьте в него ключ из буфера обмена:
- Далее, найдите в той же форме поле Адрес сервера и скопируйте его содержимое в буфер обмена:
- Не закрывая вкладки браузера с открытой страницей ЛК Webim, перейдите обратно к странице настроек API сообщества ВКонтакте и выберите вкладку Callback API / Настройки.
- Найдите поле Адрес Вашего сервера и вставьте в него адрес сервера из буфера обмена, не нажимая кнопку "Подтвердить":
- Ниже на странице настроек найдите поле Строка, которую должен вернуть сервер и скопируйте её в буфер обмена:
- Вернитесь на вкладку ЛК Webim, найдите поле Код подтверждения и вставьте в него содержимое буфера обмена:
- Ниже на странице настроек Webim найдите поле Секретный ключ и скопируйте его содержимое в буфер обмена:
- Вернитесь на страницу настроек сообщества ВКонтакте, найдите поле Секретный ключ, вставьте в него содержимое буфера обмена и нажмите Сохранить:
- Переключитесь на страницу Общих настроек Webim. В нижней части формы выберите отдел из выпадающего списка, если пользователи данного канала должны попадать только на специалистов одного отдела, или оставьте значение Без отдела:
- В самом низу формы Webim нажмите кнопку Сохранить (см. иллюстрацию выше). Введённые значения полей будут проверены и сохранены. В случае успешной проверки и сохранения настроек форма закроется, на экране снова появится страница настроек каналов общения, на которой в списке появится только что созданный канал.
- Переключитесь на страницу настроек сообщества ВКонтакте и нажмите кнопку Подтвердить (если настройки вводятся повторно, кнопка будет называться Обновить). После этого данные проверяются, и в случае успеха настройки сохранятся, а ниже появится надпись Адрес сервера успешно сохранён:
- Выберите вкладку Callback API / Типы событий. На ней в разделе Сообщения отметьте флажок в поле Входящее сообщение, чтобы сервер Webim начал получать от сети ВКонтакте уведомления о новых личных сообщениях в Вашем сообществе:
Если у Вас Webim старее версии 8.14, обратитесь, пожалуйста, в службу технической поддержки для обновления сервиса.
Откроется страница Настройки выбранного сообщества.
Откроется форма Создание ключа доступа.
Откроется форма Подтверждение действия.
В случае ввода правильного кода Вы вернётесь на страницу Работа с API.
В ином случае на этом же месте появится сообщение об ошибке:
На этом настройка интеграции между сервисами Webim и ВКонтакте завершена.
Как использовать интеграцию
Теперь, когда пользователи будут отправлять личные сообщения в Ваше сообщество ВКонтакте, эти сообщения будут не только отображаться в интерфейсе ВКонтакте и приходить администраторам и редакторам сообщества, но и появляться в очереди обращений сервиса Webim.
Чтобы испытать настроенную интеграцию, выполните следующие шаги:
- Откройте главную страницу Вашего сообщества под любой учётной записью ВКонтакте, имеющей хотя бы минимальный уровень доступа к сообществу:
- Нажмите кнопку Написать сообщение (см. иллюстрацию выше). Откроется страница диалога.
- Отправьте тестовое личное сообщение в сообщество.
- Администраторы и редакторы сообщества увидят переписку на странице Сообщения сообщества / Просмотр диалога:
- Ваши операторы и администраторы Webim увидят этот же диалог на странице Рабочее место оператора.
- На странице управления сообщество в сети ВКонтакте можно просматривать лог обмена сообщениями через механизм интеграции с сервисом Webim на вкладке Работа с API / Callback API / Запросы:
Лог работы интеграции сервисов Webim и ВКонтакте:
Когда поступит обращение от посетителя из ВКонтакте, оно отобразится в РМО в разделе Ожидают ответа и будет перемещено в раздел В диалоге с Вами после того, как оператор возьмёт его в обработку. В качестве точки входа в карточке предпросмотра диалога, а также в разделе РМО Информация о посещении будет указан сайт vk.com.
В этом примере последний из активных диалогов с данным оператором идёт через группу ВКонтакте.
Информация о посетителе будет отображена в РМО в одноименном разделе. ВКонтакте передаёт следующие поля о посетителе:
Имя. Здесь отобразится имя профиля посетителя во ВКонтакте. Если данное имя не соответствует настоящему имени посетителя и Вы хотите его поменять, это можно сделать при помощи кнопки Изменить информацию о посетителе. После введения нового имени оно заменит имя, переданное ВКонтакте, в соответствующем поле.
ID пользователя в канале. Данное поле отображает уникальный 8-значный ID пользователя во ВКонтакте. Данный ID находится в URL профиля: https://vk.com/id13427043, где 13427043 и является ID профиля. Зачастую вместо данного ID у пользователя в URL профиля отображается буквенный идентификатор, который также является уникальным, однако передаётся именно числовой ID. Данное поле в разделе Информация о посетителе отредактировать нельзя.
VK профиль. Данное поле содержит полный URL профиля, включая численный. Как и поле ID пользователя в канале, данное поле отредактировать невозможно. Пример: https://vk.com/id13427043.