1. Главная
  2. Документация
  3. Подключение ВКонтакте

Подключение ВКонтакте

Ключ сообщества, заявки, ссылки с меткой и ограничения.

Личные сообщения вашему сообществу ВКонтакте приходят в раздел «Чаты» рядом с Telegram, MAX, Авито и чатом на сайте. Сотрудники отвечают из CRM, ответ уходит пользователю от имени сообщества. Каждый новый собеседник создаёт заявку с источником «ВКонтакте». Подключает сообщество администратор компании.

Что нужно

  • Вы администратор сообщества ВКонтакте (группы, публичной страницы или мероприятия).
  • В сообществе включены сообщения: «Управление» -> «Сообщения» -> «Сообщения сообщества: включены».

Шаг 1. Создайте ключ сообщества

  1. Откройте сообщество в браузере на компьютере (в мобильном приложении ВКонтакте этого раздела нет).
  2. «Управление» -> «Работа с API» -> вкладка «Ключи доступа» -> «Создать ключ». Если раздела не видно, откройте адрес https://vk.com/clubID?act=tokens, подставив вместо ID номер сообщества.
  3. Отметьте права «Разрешить приложению доступ к управлению сообществом», «... к сообщениям сообщества», «... к фотографиям сообщества» и «... к документам сообщества», нажмите «Создать» и подтвердите действие.
  4. Скопируйте ключ.

Шаг 2. Подключите сообщество в CRM

  1. Откройте «Настройки компании» -> «Интеграции» и выберите вкладку «ВКонтакте».
  2. Вставьте ключ в поле «Ключ сообщества» и нажмите «Подключить».

В строке «Состояние» появится «Подключаем сообщество, это займёт несколько секунд», затем «Работает» и адрес сообщества со ссылкой. Ключ хранится в зашифрованном виде и после сохранения не показывается. CRM сама добавит в сообщество сервер Callback API с названием «LinkodiumCRM» и включит нужные события: ничего настраивать вручную не нужно. Одно сообщество можно подключить только к одной компании.

Для проверки напишите сообществу в личные сообщения с другого профиля: переписка появится в разделе «Чаты», а в разделе «Заявки» новая заявка.

Как приходят заявки

  • Новый собеседник = новая заявка с источником «ВКонтакте». Повторные сообщения того же человека попадают в ту же переписку.
  • Имя, фото и ссылка на профиль берутся из ВКонтакте.
  • Ссылки с меткой. Чтобы видеть, откуда пришёл человек, используйте ссылку на сообщения сообщества с меткой: https://vk.me/адрес_сообщества?ref=site_footer. Источник заявки станет «ВКонтакте · site_footer». Готовые ссылки собирает генератор на вкладке «ВКонтакте».
  • Ответы прямо во ВКонтакте. Если администратор ответил в сообщениях сообщества во ВКонтакте, ответ появится в CRM с пометкой «Отправлено из ВКонтакте».

Что работает в переписке

  • Текст. Длинный ответ CRM разделит на несколько сообщений сама.
  • Файлы от сотрудника. Картинки уходят фотографиями, голосовые голосовыми сообщениями, остальные файлы документами, до 50 МБ, каждый файл отдельным сообщением.
  • Файлы от пользователя. Фото, документы, голосовые, стикеры и граффити сохраняются в CRM (до 20 МБ). Видео, аудиозаписи, записи со стены, товары и ссылки приходят строкой со ссылкой. Прочее (опросы, подарки, истории) приходит строкой «Клиент прислал ...: ВКонтакте не передаёт такое в CRM».
  • Правка и удаление ответа у пользователя возможны в течение 24 часов после отправки.
  • Правка сообщения пользователем меняет текст и в CRM.
  • Первым написать нельзя: сообщество пишет только тем, кто написал первым или разрешил сообщения. Если человек запретил сообщения от сообщества, в переписке появится отметка «Запретил сообщения», ответы ему не уходят.
  • Сообщения из бесед, где состоит сообщество, в CRM не попадают: только личные сообщения.

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

  • «Заявки из чатов»: кто становится ответственным за новую заявку, и перевод «Новой заявки» в «В работе» первым ответом. Настройка общая для всех каналов компании.
  • «Канал»: название источника заявок, менеджер канала, приветствие, ответ в нерабочее время и расписание.
  • «Ссылки с меткой»: генератор ссылок vk.me с меткой.

Подробности: Автоответы и права.

Частые проблемы

Что видноЧто делать
«Это не похоже на ключ сообщества»Скопируйте ключ целиком, без пробелов.
«Это ключ пользователя, а нужен ключ сообщества»Создайте ключ в самом сообществе: «Управление» -> «Работа с API» -> «Ключи доступа».
«ВКонтакте не принимает ключ сообщества»Ключ удалён. Создайте новый ключ и нажмите «Заменить ключ».
«Ключу сообщества не хватает прав»В «Работа с API» -> «Ключи доступа» отметьте у ключа права на управление, сообщения, фотографии и документы. Канал заработает сам в течение минуты.
«У сообщества уже 10 серверов Callback API»Удалите ненужный сервер в «Управление» -> «Работа с API» -> «Callback API». Канал подключится сам.
«Это сообщество уже подключено к другой компании в Linkodium CRM»Отключите его в той компании и подождите пару минут.
«Подключение затянулось»Подождите: CRM повторяет попытки сама. Если состояние не меняется, напишите в поддержку.

Владелец и администраторы компании получают служебное уведомление в Telegram или MAX, если ВКонтакте перестал принимать ключ сообщества («Канал ВКонтакте отключён») или ключу не хватает прав. Ссылка в уведомлении ведёт на вкладку «Интеграции».

Отключение

На вкладке «ВКонтакте» нажмите «Отключить» и подтвердите. CRM удалит свой сервер Callback API из сообщества, сообщения перестанут приходить в CRM, переписка сохранится и останется доступной для чтения.