ВКонтакте
На этой странице содержатся все сведения об интеграции сервиса Webim в социальную сеть ВКонтакте.
Зачем нужна интеграция
Многие организации используют большое число каналов для привлечения клиентов и регистрации заказов. У каждого пользователя свои предпочтения: одни используют мессенджеры, другие социальные сети, третьи службы онлайн-консультирования на сайте. Для операторов компаний, предоставляющих услуги/товары, это выливается в проблему: необходимо мониторить множество служб с разными интерфейсами параллельно. Операторам приходится переключаться между сервисами, ловить сообщения от пользователей, которые те отправляют то через один канал, то через другой. На этом теряется внимание, время.
Для многих из наших клиентов мы упрощаем работу с помощью возможности по интеграции сервиса Webim с сообществами в социальной сети ВКонтакте.
Если настроить эту интеграцию между сообществом VK и аккаунтом Webim, то все сообщения пользователей попадут в общую очередь и будут распределяться из неё между операторами. Общий интерфейс, общая очередь, общий список операторов и механизм обработки обращений. Это удобно и эффективно.
Мы поддерживаем все виды сообществ VK:
-
Бизнес
-
Тематическое сообщество
-
Бренд или организация
-
Публичная страница
-
Мероприятие
Одну учётную запись Webim можно связать с одним сообществом сети ВКонтакте.
N.B.
Речь о личных сообщениях, которые отправляются пользователями администраторам и редакторам сообщества (через функциональность Написать сообщение под фотографией профиля сообщества).
О возможностях и ограничениях интеграции сервиса Webim с социальной сетью ВКонтакте Вы можете прочитать в этой статье.
Инструкция по настройке
Чтобы включить интеграцию на Вашем аккаунте Webim, выполните следующие шаги:
-
Отправьте в службу технической поддержки запрос на активацию функции интеграции с сообществами ВКонтакте.
-
После того как версия Webim обновлена, войдите в сеть ВКонтакте и откройте страницу сообщества, которое хотите связать с учётной записью Webim.
-
В меню справа нажмите Управление.
Откроется страница Настройки выбранного сообщества.
-
Вам нужно использовать для входа такую учётную запись ВКонтакте, которая имеет статус Владелец или Администратор в этом сообществе. Чтобы увидеть статус аккаунтов руководства сообществом, в меню справа откройте Руководители.
Внимание!
Роли Редактор, Модератор и Рекламодатель для настройки интеграции не подходят: у них нет доступа к разделу Управление, а значит, и к разделу Дополнительно → Работа с API, в котором создаётся ключ доступа (см. шаг 7). Если в интерфейсе сообщества нет пункта Управление или в его настройках отсутствует раздел Работа с API, попросите владельца сообщества назначить Вас администратором либо создать ключ доступа самостоятельно и передать его Вам.
-
Убедитесь, что в этом сообществе включены сообщения. Для этого в меню справа откройте Сообщения.
-
Найдите опцию Сообщения сообщества. Если сообщения выключены, включите их и нажмите Сохранить.
-
В меню справа откройте Дополнительно, затем Работа с API. На вкладке Ключи доступа нажмите Создать ключ.
Откроется форма Создание ключа доступа.
-
В этой форме выберите следующие пункты:
- Разрешить приложению доступ к сообщениям сообщества — в любом случае;
- Разрешить приложению доступ к фотографиям сообщества — в этом случае изображения будут передаваться в VK как фотографии, иначе — как ссылки;
- Разрешить приложению доступ к документам сообщества — в этом случае файлы некоторых типов будут передаваться в VK как документы, иначе — как ссылки.
Затем нажмите кнопку Создать.
Откроется форма Подтверждение действия.
-
Вид и функциональность этой формы зависят от персональных настроек аккаунта. Если система предлагает выбор, выберите удобный и доступный способ подтверждения, например с помощью SMS с кодом на номер, привязанный к Вашему аккаунту VK.
В случае успешного подтверждения Вы вернётесь на страницу Работа с API.
-
На этой странице обратите внимание на появление сведений о только что созданном ключе. Выделите этот ключ доступа и скопируйте его в буфер обмена.
-
На вкладке Callback API откройте Настройки сервера и в поле Версия API выберите
5.199. -
Не закрывая вкладки браузера со страницей сообщества ВКонтакте, откройте новую вкладку браузера с Панелью управления сервиса Webim, раздел Настройки, пункт Каналы общения и найдите ВКонтакте.
-
В блоке настроек каналов ВКонтакте нажмите кнопку Добавить. Откроется форма Добавление сообщества ВКонтакте.
-
В поле Название канала введите имя, под которым этот канал будет отображаться в РМО.
-
Найдите поле Ключ доступа и вставьте в него ключ из буфера обмена.
-
Далее найдите в той же форме поле Адрес сервера и скопируйте его содержимое в буфер обмена.
-
Не закрывая вкладки браузера с открытой страницей Webim, перейдите обратно к странице настроек API сообщества ВКонтакте и выберите вкладку Callback API -> Настройки.
-
Найдите поле Адрес и вставьте в него адрес сервера из буфера обмена.
-
Ниже на странице настроек найдите поле Строка, которую должен вернуть сервер и скопируйте её в буфер обмена.
-
Вернитесь на вкладку Webim, найдите поле Код подтверждения и вставьте в него содержимое буфера обмена.
-
Ниже на странице настроек Webim найдите поле Секретный ключ и скопируйте его содержимое в буфер обмена.
-
Вернитесь на страницу настроек сообщества ВКонтакте, найдите поле Секретный ключ, вставьте в него содержимое буфера обмена и нажмите Сохранить.
-
Вновь переключитесь на страницу создания канала Webim. В нижней части формы выберите, требуется ли выбор отдела, и, в зависимости от этого, укажите отдел, в который будут попадать обращения, или выберите отделы, из которых сможет выбирать посетитель. Там же есть Внешний идентификатор и Автоотключение при ошибках: первое нужно, только если к аккаунту подключён бот ЦРТ; второе задаёт, сколько подряд невосстановимых ошибок допускается до отключения канала (
0— не отключать). Оба поля описаны в разделе Каналы общения.Если планируется выбор отдела или кнопочные сообщения
Чтобы в ВКонтакте меню выбора отдела отображалось клавиатурой с кнопками, а не обычным текстом, в настройках сообщества включите сообщения и возможности ботов.
-
Откройте страницу Вашего сообщества и в меню справа нажмите Управление.
-
Откройте раздел Сообщения. Убедитесь, что Сообщения сообщества включены. Если сообщения выключены — включите их и нажмите Сохранить.
-
Откройте Настройки для бота (пункт меню под разделом Сообщения). Включите Возможности ботов и нажмите Сохранить.
Если эти опции выключены или ограничены на стороне ВКонтакте, кнопки не отобразятся: посетитель увидит тот же выбор в виде текста с нумерованным списком и сможет ответить, введя цифру вручную. Отдельно: ВКонтакте допускает не более 10 кнопок в одном сообщении — при большем числе вариантов список также показывается текстом.
-
-
В самом низу формы Webim нажмите кнопку Сохранить. Введённые значения полей будут проверены и сохранены. В случае успешной проверки и сохранения настроек форма закроется, на экране снова появится страница настроек каналов общения, на которой в списке появится только что созданный канал.
-
Переключитесь на страницу настроек сообщества ВКонтакте и нажмите кнопку Подтвердить (если настройки вводятся повторно, кнопка будет называться Обновить). После этого данные проверяются, и в случае успеха настройки сохранятся, а ниже появится надпись Адрес сервера успешно сохранён.
В ином случае на этом же месте появится сообщение об ошибке Сервер вернул неправильный ответ.
-
Теперь выберите вкладку Callback API -> Типы событий. На ней в разделе Сообщения отметьте флажок в поле Входящее сообщение, чтобы сервер Webim начал получать от сети ВКонтакте уведомления о новых личных сообщениях в Вашем сообществе.
На этом настройка интеграции между Webim и ВКонтакте завершена.
Как использовать интеграцию
Теперь, когда пользователи будут отправлять личные сообщения в Ваше сообщество ВКонтакте, эти сообщения будут не только отображаться в интерфейсе ВКонтакте и приходить администраторам и редакторам сообщества, но и появляться в очереди обращений сервиса Webim.
Чтобы испытать настроенную интеграцию, выполните следующие шаги:
-
Откройте главную страницу Вашего сообщества под любой учётной записью ВКонтакте, имеющей хотя бы минимальный уровень доступа к сообществу.
-
Нажмите кнопку Сообщение. Откроется страница диалога.
-
Отправьте тестовое личное сообщение в сообщество.
-
Администраторы и редакторы сообщества увидят переписку на странице Сообщения сообщества -> Просмотр диалога.
-
Ваши операторы и администраторы Webim увидят этот же диалог на странице Рабочее место оператора.
Когда поступит обращение от посетителя из ВКонтакте, оно отобразится в РМО в разделе Ожидают ответа и будет перемещено в раздел В диалоге с Вами после того, как оператор возьмёт его в обработку. В точке входа указан канал ВКонтакте, в поле Тип канала — VK.
Информация о посетителе будет отображена в РМО в одноимённом разделе. ВКонтакте передаёт следующие поля о посетителе:
- Имя. Здесь отобразится имя профиля посетителя во ВКонтакте. Если данное имя не соответствует настоящему имени посетителя и Вы хотите его поменять, это можно сделать при помощи кнопки Изменить информацию о посетителе. После введения нового имени оно заменит имя, переданное ВКонтакте, в соответствующем поле.
- ID пользователя в канале. Данное поле отображает уникальный 8-значный ID пользователя во ВКонтакте. Данный ID находится в URL профиля:
https://vk.ru/id12345678, где12345678и является ID профиля. Зачастую вместо данного ID у пользователя в URL профиля отображается буквенный идентификатор, который также является уникальным, однако передаётся именно числовой ID. Данное поле в разделе Информация о посетителе отредактировать нельзя. - VK профиль. Данное поле содержит полный URL профиля, включая численный идентификатор. Как и поле ID пользователя в канале, данное поле отредактировать невозможно. Пример:
https://vk.ru/id12345678.
На странице управления сообществом в сети ВКонтакте можно просматривать лог обмена сообщениями через механизм интеграции с сервисом Webim на вкладке Работа с API -> Callback API -> Запросы.
Что делать, если интеграция перестала работать
Бывает, что уже настроенная интеграция перестаёт работать: сообщения из сообщества не попадают в очередь Webim, ответы операторов не доходят до посетителей, а на вкладке Работа с API -> Callback API -> Запросы в сообществе ВКонтакте появляются ошибки.
Чаще всего это происходит по одной из следующих причин:
-
ключ доступа сообщества отозван или удалён — например, руководитель, создавший ключ, лишился прав в сообществе, или ключ был пересоздан вручную;
-
у ключа доступа изменился набор прав: отключён доступ к сообщениям, фотографиям или документам сообщества;
-
в сообществе выключены Сообщения сообщества или Возможности ботов;
-
в настройках Callback API сообщества изменены или сброшены адрес сервера, код подтверждения, секретный ключ, версия API либо снят флажок Входящее сообщение в типах событий.
Сначала попробуйте починить уже созданный канал: ключ доступа и код подтверждения в нём можно обновить. Адрес сервера и секретный ключ выдаются один раз при создании и при редактировании не меняются.
-
Создайте в сообществе ВКонтакте новый ключ доступа, как в инструкции по настройке.
-
В Панели управления Webim откройте существующий канал ВКонтакте и вставьте новый ключ в поле Ключ доступа. При необходимости обновите Код подтверждения из настроек Callback API сообщества и сохраните канал.
-
Во ВКонтакте откройте уже существующий сервер Callback API этого сообщества и проверьте адрес сервера, секретный ключ, версию API
5.199и флажок Входящее сообщение. Не добавляйте второй сервер Callback API: несколько серверов для одного сообщества настраивать не нужно — правьте текущий. -
Проверьте работу по разделу Как использовать интеграцию: отправьте тестовое сообщение в сообщество и убедитесь, что обращение появилось в РМО.
Если после обновления ключа и настроек Callback API интеграция всё равно не работает, создайте канал заново:
-
Пройдите инструкцию по настройке и создайте в Панели управления Webim новый канал ВКонтакте.
-
В настройках Callback API сообщества измените адрес сервера, код подтверждения и секретный ключ на значения нового канала: у каждого канала они свои, от старого канала не подходят. Редактируйте существующий сервер Callback API, не добавляйте второй.
-
Проверьте работу нового канала по разделу Как использовать интеграцию.
-
Убедившись, что новый канал работает, удалите старый канал ВКонтакте в разделе Настройки -> Каналы общения.
Если после пересоздания канала интеграция всё равно не работает, обратитесь в службу технической поддержки. В обращении укажите название аккаунта Webim и сообщества ВКонтакте, время последней неудачной попытки, а также приложите скриншот вкладки Работа с API -> Callback API -> Запросы с текстом ошибки.