- Главная
- Документация
- Подключение ВКонтакте
Подключение ВКонтакте
Ключ сообщества, заявки, ссылки с меткой и ограничения.
Личные сообщения вашему сообществу ВКонтакте приходят в раздел «Чаты» рядом с Telegram, MAX, Авито и чатом на сайте. Сотрудники отвечают из CRM, ответ уходит пользователю от имени сообщества. Каждый новый собеседник создаёт заявку с источником «ВКонтакте». Подключает сообщество администратор компании.
Что нужно
- Вы администратор сообщества ВКонтакте (группы, публичной страницы или мероприятия).
- В сообществе включены сообщения: «Управление» -> «Сообщения» -> «Сообщения сообщества: включены».
Шаг 1. Создайте ключ сообщества
- Откройте сообщество в браузере на компьютере (в мобильном приложении ВКонтакте этого раздела нет).
- «Управление» -> «Работа с API» -> вкладка «Ключи доступа» -> «Создать ключ». Если раздела не видно, откройте адрес https://vk.com/clubID?act=tokens, подставив вместо ID номер сообщества.
- Отметьте права «Разрешить приложению доступ к управлению сообществом», «... к сообщениям сообщества», «... к фотографиям сообщества» и «... к документам сообщества», нажмите «Создать» и подтвердите действие.
- Скопируйте ключ.
Шаг 2. Подключите сообщество в CRM
- Откройте «Настройки компании» -> «Интеграции» и выберите вкладку «ВКонтакте».
- Вставьте ключ в поле «Ключ сообщества» и нажмите «Подключить».
В строке «Состояние» появится «Подключаем сообщество, это займёт несколько секунд», затем «Работает» и адрес сообщества со ссылкой. Ключ хранится в зашифрованном виде и после сохранения не показывается. 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, переписка сохранится и останется доступной для чтения.