Интеграция с ВКонтакте


 

 

Особенности работы

 

Максимальная длина текстового сообщения составляет 4096 символов.

 

Если вы хотите, чтобы наши чат-боты работали с ВК, нужно произвести указанные настройки.

 

В работе чат-ботов с ВК имеются следующие ограничения:

  • максимальная длина текста в кнопке - 40 символов;
  • максимальное количество кнопок, которое можно отправить в одном сообщении в ВК - 10.

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

Об особенностях настройки ботов вы можете прочитать в статье "Боты".

 

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

 

Если администратор группы ВК отвечает в обсуждении или в комментариях, то его сообщения не попадают в программу оператора и не вызывают никаких событий.

 

 

Данные о клиенте

 

При использовании интеграции ВКонтакте передает следующие данные о пользователе:

Профиль. Это уникальный идентификатор пользователя. С помощью него вы можете открыть страницу пользователя.

Имя и фамилия пользователя. Если у пользователя указаны имя и фамилия, они будут отображены.

Аватар пользователя. Отображает аватар пользователя.

Источник. Показывает откуда написал пользователь (например, личные сообщения или комментарий к посту).

Ссылка на диалог. Отображает ссылку на диалог с пользователем (есть только у личных сообщений).

 

ВКонтакте не передает номер мобильного телефона и адрес электронной почты пользователя.

 

 

Как подключить интеграцию

 

Для создания интеграции вам необходимо зарегистрироваться и создать новый проект.

О том, как создать проект, рассказано в данной статье.

 

Зайдите в Личный кабинет и откройте список подключенных сайтов.

Кликните на кнопку "Настройки" в контейнере с нужным вам сайтом и в появившемся слева списке меню выберите раздел "Каналы связи". В открывшемся окне вы увидите список подключенных интеграций.

 
 

Для создания новой интеграции нажмите кнопку "Добавить интеграцию" и выберите VK.

 
 

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

 
 

В следующем окне нужно выбрать аккаунт для интеграции.

 
 

Далее нужно выбрать группу для интеграции.

 
 

Клик на группу откроет в браузере новое окно, в котором нужно разрешить доступ к выбранной группе.

 
 

После этих действий в разделе "Каналы связи" появится новая интеграция с ВКонтакте.

 
 

 

Настройка возможности отвечать на комментарии к постам

 

Зайдите в Личный кабинет и откройте список подключенных сайтов.

Кликните на кнопку "Настройки" в контейнере с нужным вам сайтом и в появившемся слева списке меню выберите раздел "Каналы связи". В открывшемся окне вы увидите список подключенных интеграций.

 

Для быстрого доступа к разделу "Каналы связи" можно нажать на значок любой интеграции в контейнере с проектом.

 
 

Найдите созданную вами интеграцию с VK и кликните на кнопку "Редактировать подключение".

 
 

Откроется окно с полем, в которое нужно вставить токен (ключ доступа).

 
 

Как создать токен

Откройте страницу вашей группы и перейдите в раздел "Управление" - "Настройки" - "Работа с API".

Также вы можете перейти по ссылке, расположенной под полем для токена в первом пункте инструкции.

 

Для создания токена у вас должны быть права администратора группы.

 

На странице "Работа с API" нужно нажать на кнопку "Создать ключ".

 
 

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

 
 

Далее для подтверждения действия на ваш мобильный телефон будет отправлено сообщение с кодом.

 
 

Отправьте код и скопируйте созданный ключ.

 
 

Вернитесь в Личный кабинет в раздел "Настройки" - "Каналы связи".

Найдите интеграцию с ВКонтакте и нажмите кнопку "Редактировать подключение". Вставьте скопированный ключ в поле для токена и нажмите кнопку "Сохранить".

 
 

В браузере откроется новое окно с запросом доступа к вашей группе. Нажмите кнопку "Разрешить" для завершения настройки и обновите страницу Личного кабинета.

 
 

 

Настройки для подключения чат-ботов

 

Откройте страницу вашей группы и перейдите в раздел "Управление" - "Сообщения".

Проверьте, что сообщения сообщества включены. Если они отключены, включите их и нажмите кнопку "Сохранить".

 
 

Далее перейдите в раздел "Управление" - "Сообщения" - "Настройки для бота".

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

 
 

О настройках чат-ботов вы можете прочитать в статье "Боты".

 

 

Как разместить ссылку на свою группу VK

 

Ссылку на группу ВК можно разместить на своем сайте, в меню кнопки виджета или в меню виджета. Ссылка должна вести на адрес https://vk.com/club1112233, где "club1112233" - это ID вашей группы ВК.

 

Взять ссылку на свою группу ВК можно из Личного кабинета в разделе "Каналы связи". Наведите курсор на название вашей группы ВК, кликните на него правой кнопкой мыши и выберите "Копировать ссылку".

 

Клик на такую ссылку откроет у пользователя главную страницу вашей группы ВК.

 

О том, как разместить ссылку в меню кнопки или в меню виджета, вы можете прочитать в данной статье.

 

После того, как вы добавите интеграцию, она будет доступна для выбора в качестве элемента меню кнопки и меню виджета в разделе "Социальные сети и мессенджеры".

При клике на поле "ID группы-VK" появится список значений, которые можно подставить из успешно добавленных интеграций.

В поле "Открывать" вы можете выбрать что будет открываться при переходе по ссылке: главная страница или сообщения сообщества.

 
 

 

Дополнительные настройки

 

Для интеграции с ВКонтакте доступны следующие обрабатываемые события:

  • новое входящее сообщение;
  • исходящее сообщение;
  • сообщение прочитано;
  • исходящее сообщение (рассылка Notify);
  • новое входящее сообщение в беседе (общий чат);
  • редактирование входящего сообщения;
  • комментарий на стене;
  • запись на стене;
  • комментарий в обсуждении;
  • комментарий к фото;
  • комментарий к видео;
  • комментарий к товару.
 

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

Операторы не могут отвечать на системные уведомления. Это связано с работой API VK.

 

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

О том, как создать ключ, рассказано в параграфе "Настройка возможности отвечать на комментарии к постам".

 

Вы можете включить перечисленные дополнительные опции:

  • указывать имя оператора в ответном сообщении;
  • отправлять уведомление о прочтении после того, как оператор прочитает сообщение клиента;
  • отправлять уведомление о прочтении после того, как оператор завершит диалог.
 

 

Частые ошибки

 

Подписка на события VK не оформлена

 

Эта ошибка может появляться из-за различных причин (например, удаление используемого сервера из настроек группы ВК или удаление ключа, используемого для интеграции с группой и др.).

 
 

Для исправления ошибки в Личном кабинете в разделе "Настройки" - "Каналы связи" найдите интеграцию с ВКонтакте и нажмите кнопку "Исправить подключение".

В открывшемся окне нажмите кнопку "Сохранить" (поле "Токен для комментариев" можно не заполнять) и в следующем окне нажмите кнопку "Разрешить". Обновите страницу Личного кабинета.

 

 

Достигнут лимит количества серверов (Servers number limit is reached)

 

Данная ошибка может возникнуть при создании интеграции с VK.

 
 

Максимальное число серверов для одной группы равняется 10.

Это значит, что к одной группе ВК вы можете подключить до 10 различных сервисов.

 

Для исправления ошибки откройте страницу вашей группы ВКонтакте и перейдите в раздел "Управление" - "Настройки" - "Работа с API".

Кликните на "Callback API" - "Настройки сервера".

 
 

В правом верхнем углу показан выбранный сервер. Кликните на его название, чтобы отобразить список всех серверов, которые использует группа.

 
 

Выберите из списка сервер, который вам не нужен, и удалите его, нажав на слово "Удалить" внизу страницы. Подтвердите удаление в появившемся диалоговом окне.

 
 

Вернитесь в Личный кабинет в раздел "Настройки" - "Каналы связи" и создайте интеграцию с ВК заново.

 

Для создания интеграции воспользуйтесь данной инструкцией.

 

 

Ключ для интеграции комментариев должен быть от той же группы

 

Такая ошибка появляется при неверном вводе токена (например, при копировании ключа были пропущены несколько символов), в случае удаления используемого для интеграции комментариев ключа из настроек группы Вконтакте или при использовании ключа от другой группы ВК.

 
 

Для исправления ошибки откройте страницу вашей группы ВКонтакте и перейдите в раздел "Управление" - "Настройки" - "Работа с API". Найдите нужный ключ и нажмите "Показать".

 

Ключ для интеграции комментариев должен содержать доступ ко всем правам.

 
 

Для подтверждения действия на ваш мобильный телефон будет отправлено сообщение с кодом.

Введите полученный код и скопируйте ключ.

 
 

Вернитесь в Личный кабинет в раздел "Настройки" - "Каналы связи".

Найдите интеграцию с ВКонтакте и нажмите кнопку "Исправить подключение". Вставьте скопированный ключ в поле для токена и нажмите кнопку "Сохранить". Обновите страницу Личного кабинета.

 

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

О том, как это сделать, вы можете прочитать в данном разделе.

 

 

Ошибка авторизации пользователя (User authorization failed: invalid access_token или access_token has expired)

 

Эта ошибка может возникнуть при изменении каких-либо настроек безопасности (например, при смене пароля).

 
 

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

 

При такой ошибке интеграция продолжит работать.

 

 

Пользователь запретил отправку сообщений от имени сообщества

 

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

 
 

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

Далее нужно открыть меню чата и кликнуть на поле "Разрешить сообщения".

 
 

 

Чат-бот не включен в настройках сообщества

 
 

Эта ошибка возникает при неправильных настройках группы ВК.

Если вы хотите, чтобы наши чат-боты работали с ВКонтакте, нужно выполнить настройки, указанные в параграфе "Настройки для подключения чат-ботов".

 

 

VK API не поддерживает отправку комментариев для данного события

 
 

Данная ошибка возникает при попытке оператора ответить на комментарий пользователя к видео, фотографии или аудиозаписи.

 

Отвечать из программы оператора можно только на комментарии к постам.

На комментарии к видео, к изображению, а также к аудио отвечать из программы оператора возможности нет. Это связано с работой API VK.

280 просмотров

Другие статьи по этой теме


Общая информация для интеграций
Интеграции позволяют вам получать информацию из различных источников и отвечать клиентам в одном приложении без необходимости заходить в различные мес...
Интеграция с Telegram
Особенности работы Интеграция с Telegram работает только с Telegram-ботами. Личные аккаунты, привязанные к номерам телефонов, интегрировать не получи...
Интеграция с Viber
Особенности работы Интеграция с Viber работает только с публичными аккаунтами. Личные аккаунты, привязанные к номерам телефонов, интегрировать не пол...
Интеграция с WhatsApp
Особенности работы Контент Данные о клиенте Контент Как подключить интеграцию Для создания интеграции вам необходимо зарегистрироваться и создать...
Интеграция с Одноклассники
Особенности работы Одноклассники не присылает информацию о прочтении сообщения клиентом. Данные о клиенте При использовании интеграции ОК передает ...
Интеграция с Email
Особенности работы Чат-бот не работает с данной интеграцией. Максимальный размер письма, который может обработать наш сервис составляет 20 Мб. Данн...
Интеграция с Avito
Особенности работы На данный момент через интеграцию можно отправить только текстовое сообщение. Все остальные типы сообщения (изображение, видео и ...
Интеграция с Юла
Особенности работы Для подключения интеграции нужен бизнес-аккаунт. Обычный аккаунт подключить нельзя. Сообщения, отправленные вами из Личного кабин...
Интеграция с Дром
Особенности работы Интеграция работает только для диалогов по объявлениям из разделов "Легковые авто" и "Грузовики и спецтехника". Для остальных разд...
Интеграция с Auto.ru
Особенности работы Для подключения интеграции необходим действующий аккаунт дилера. Для обычного пользовательского аккаунта подключить интеграцию не...
Интеграция с AliExpress
Особенности работы Подключить интеграцию можно только для аккаунта продавца. На данный момент через интеграцию можно отправить только текстовое сооб...