ВКонтакте

Зачем нужна интеграция

Многие организации используют большое число каналов для привлечения клиентов и регистрации заказов. У каждого пользователя свои предпочтения: одни используют мессенджеры, другие социальные сети, третьи службы онлайн-консультирования на сайте. Для операторов компаний, предоставляющих услуги/товары, это выливается в проблему: необходимо мониторить множество служб с разными интерфейсами параллельно. Операторам приходится переключаться между сервисами, ловить сообщения от пользователей, которые те отправляют то через один канал, то через другой. На этом теряется внимание, время.

Для многих из наших клиентов мы упрощаем работу с помощью новой возможности по интеграции сервиса Webim и сообщества соц. сети ВКонтакте.

Если настроить эту интеграцию между сообществом ВК и аккаунтом Webim, то все сообщения пользователей попадут в общую очередь и буду распределяться из неё между операторами. Общий интерфейс, общая очередь, общий список операторов и механизм обработки обращений. Это удобно и эффективно.

Мы поддерживаем все виды сообществ (communities) ВК:

• группы (groups)
• публичные страницы (public pages)
• мероприятия (events).

Одну учётную запись Webim можно связать с одним сообществом сети ВКонтакте.

NB: Речь о личных сообщениях, которые отправляются пользователями администраторам и редакторам сообщества (через функциональность Отправить сообщение, а не через функцию Написать сообщение на стене) и не о комментариях к постам.

Инструкция по настройке

Чтобы включить интеграцию на Вашем аккаунте Webim, выполните следующие шаги:

1. Зайдите в Панель управления сервиса Webim и проверьте номер своей версии сервиса. Номер версии отображается слева внизу каждой страницы:
Найти номер версии Webim:



Если у Вас Webim старее версии 8.14, обратитесь, пожалуйста, в службу технической поддержки для обновления сервиса.

2. Отправьте в службу технической поддержки запрос на активацию функции интеграции с сообществами ВКонтакте.
3. После того как версия Webim обновлена, войдите в сеть ВКонтакте и откройте страницу сообщества, которое хотите связать с учётной записью Webim.
4. Нажмите кнопку Управление сообществом (Manage community):
Управление сообществом ВКонтакте:



Откроется страница Настройки выбранного сообщества.

5. Вам нужно использовать для входа такую учётную запись ВКонтакте, которая имеет статус Владелец, Администратор или Редактор в этом сообществе.Чтобы увидеть статус аккаунтов руководства сообществом, выберите вкладку Участники (Members), на ней Руководители (Management):
   Найти статус руководителей сообществом ВКонтакте:

   

6. Убедитесь, что в этом сообществе включен сервис сообщений. Для этого перейдите на страницу Сообщения выбранного сообщества:
Включение сервиса сообщений сообщества ВКонтакте:



7. Найдите опцию Сообщения сообщества (выделена красным на иллюстрации выше). Если сообщения выключены, включите их.
8. На странице настроек сообщества перейдите к разделу Работа с API. Там выберите вкладку Ключи доступа и нажмите кнопку Создать ключ:
Вкладка работы с API сообщества ВКонтакте:



Откроется форма Создание ключа доступа.

9. В этой форме выберите следующие пункты:
   • Разрешить приложению доступ к сообщениям сообщества — в любом случае;
   • Разрешить приложению доступ к фотографиям сообщества — в этом случае изображения будут передаваться в ВК как фотографии, иначе — как ссылки;
   • Разрешить приложению доступ к документам сообщества — в этом случае файлы некоторых типов будут передаваться в ВК как документы, иначе — как ссылки.

   Затем нажмите кнопку Создать:

Форма создания ключа доступа:



Откроется форма Подтверждение действия.

10. Вид и функциональность этой формы зависят от персональных настроек аккаунта и мобильного устройства. Если система предлагает выбор, то выберите удобный и доступный способ подтверждения, например, через SMS:
Форма подтверждения действия:



11. Дождитесь короткого сообщения на телефон с кодом подтверждения.
12. Введите его в поле Код подтверждения и нажмите кнопку Отправить код:
Ввод кода подтверждения:



В случае ввода правильного кода Вы вернётесь на страницу Работа с API.

13. На этой странице обратите внимание на появление сведений о только что созданном ключе. Выделите этот ключ доступа и скопируйте его в буфер обмена:
Копирование ключа доступа сообщества ВКонтакте:



14. Переключитесь на вкладку Callback API и выберите в поле Версия API значение 5.92:
Выбор версии API:



15. Не закрывая вкладки браузера с открытой страницей сообщества ВКонтакте, откройте новую вкладку браузера с Панелью управления сервиса Webim, страница Общих настроек, раздел Каналы общения:
Раздел настроек каналов общения Webim:



16. В блоке настроек каналов ВКонтакте нажмите кнопку Добавить сообщество. Откроется форма Добавление сообщества ВКонтакте:
Форма настроек Webim для добавления сообщества ВКонтакте:



17. Найдите поле Название сообщества и введите там наименование, под которым этот канал будет отображаться в Личном кабинете оператора.
18. Найдите поле Ключ доступа и вставьте в него ключ из буфера обмена:
Настройки интеграции Webim и ВКонтакте:



19. Далее, найдите в той же форме поле Адрес сервера и скопируйте его содержимое в буфер обмена:
Адрес сервера Webim:



20. Не закрывая вкладки браузера с открытой страницей ЛК Webim, перейдите обратно к странице настроек API сообщества ВКонтакте и выберите вкладку Callback API / Настройки.
21. Найдите поле Адрес Вашего сервера и вставьте в него адрес сервера из буфера обмена, не нажимая кнопку "Подтвердить":
Адрес сервера Webim для Callback API:



22. Ниже на странице настроек найдите поле Строка, которую должен вернуть сервер и скопируйте её в буфер обмена:
Строка, которую должен вернуть сервер Webim:



23. Вернитесь на вкладку ЛК Webim, найдите поле Код подтверждения и вставьте в него содержимое буфера обмена:
Указание кода подтверждения сервера Webim:



24. Ниже на странице настроек Webim найдите поле Секретный ключ и скопируйте его содержимое в буфер обмена:
Секретный ключ Webim:



25. Вернитесь на страницу настроек сообщества ВКонтакте, найдите поле Секретный ключ, вставьте в него содержимое буфера обмена и нажмите Сохранить:
Вставка секретного ключа Webim:



26. Переключитесь на страницу Общих настроек Webim. В нижней части формы выберите отдел из выпадающего списка, если пользователи данного канала должны попадать только на специалистов одного отдела, или оставьте значение Без отдела:
Выбор отдела Webim:



27. В самом низу формы Webim нажмите кнопку Сохранить (см. иллюстрацию выше). Введённые значения полей будут проверены и сохранены. В случае успешной проверки и сохранения настроек форма закроется, на экране снова появится страница настроек каналов общения, на которой в списке появится только что созданный канал.
28. Переключитесь на страницу настроек сообщества ВКонтакте и нажмите кнопку Подтвердить (если настройки вводятся повторно, кнопка будет называться Обновить). После этого данные проверяются, и в случае успеха настройки сохранятся, а ниже появится надпись Адрес сервера успешно сохранён:
Сохранение настроек сообщества ВКонтакте - успех:



В ином случае на этом же месте появится сообщение об ошибке:

Сохранение настроек сообщества ВКонтакте - ошибка:



29. Выберите вкладку Callback API / Типы событий. На ней в разделе Сообщения отметьте флажок в поле Входящее сообщение, чтобы сервер Webim начал получать от сети ВКонтакте уведомления о новых личных сообщениях в Вашем сообществе:
Включение уведомлений о новых сообщениях ВК:



На этом настройка интеграции между сервисами Webim и ВКонтакте завершена.

 

---

Как использовать интеграцию

Теперь, когда пользователи будут отправлять личные сообщения в Ваше сообщество ВКонтакте, эти сообщения будут не только отображаться в интерфейсе ВКонтакте и приходить администраторам и редакторам сообщества, но и появляться в очереди обращений сервиса Webim.

Чтобы испытать настроенную интеграцию, выполните следующие шаги:

1. Откройте главную страницу Вашего сообщества под любой учётной записью ВКонтакте, имеющей хотя бы минимальный уровень доступа к сообществу:

• Нажмите кнопку Написать сообщение (см. иллюстрацию выше). Откроется страница диалога.
• Отправьте тестовое личное сообщение в сообщество.
• Администраторы и редакторы сообщества увидят переписку на странице Сообщения сообщества / Просмотр диалога:
Просмотр диалога в сообществе ВКонтакте:



 

• Ваши операторы и администраторы Webim увидят этот же диалог на странице Рабочее место оператора.

Когда поступит обращение от посетителя из ВКонтакте, оно отобразится в РМО в разделе Ожидают ответа и будет перемещено в раздел В диалоге с Вами после того, как оператор возьмёт его в обработку. В качестве точки входа в карточке предпросмотра диалога, а также в разделе РМО Информация о посещении будет указан сайт vk.com.

Диалог с пользователем ВК в РМО:



В этом примере последний из активных диалогов с данным оператором идёт через группу ВКонтакте.

Информация о посетителе будет отображена в РМО в одноименном разделе. ВКонтакте передаёт следующие поля о посетителе:

Имя. Здесь отобразится имя профиля посетителя во ВКонтакте. Если данное имя не соответствует настоящему имени посетителя и Вы хотите его поменять, это можно сделать при помощи кнопки Изменить информацию о посетителе. После введения нового имени оно заменит имя, переданное ВКонтакте, в соответствующем поле.

ID пользователя в канале. Данное поле отображает уникальный 8-значный ID пользователя во ВКонтакте. Данный ID находится в URL профиля: https://vk.com/id13427043, где 13427043 и является ID профиля. Зачастую вместо данного ID у пользователя в URL профиля отображается буквенный идентификатор, который также является уникальным, однако передаётся именно числовой ID. Данное поле в разделе Информация о посетителе отредактировать нельзя.

VK профиль. Данное поле содержит полный URL профиля, включая численный. Как и поле ID пользователя в канале, данное поле отредактировать невозможно. Пример: https://vk.com/id13427043.

• На странице управления сообщество в сети ВКонтакте можно просматривать лог обмена сообщениями через механизм интеграции с сервисом Webim на вкладке Работа с API / Callback API / Запросы:
  Лог работы интеграции сервисов Webim и ВКонтакте:
  

 

---