ВКонтакте: подключение сообщений сообщества

Включение «Сообщений сообщества»

На стороне ВК (vk.com):

1. Откройте свое сообщество → Управление (в правом меню).
2. Сообщения → переключите тумблер Сообщения сообщества → Включены.
3. Опционально:

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

Получение Access Token

1. Управление → Настройки → Работа с API (или сразу vk.com/?act=tokens).
2. Вкладка Ключи доступа → Создать ключ.
3. Выберите права (галки):

- ✓ Сообщения сообщества — обязательно (без этого вебхук'и не настроить). - ✓ Фотографии — если планируете отправлять/получать фото. - ✓ Документы — если планируете отправлять файлы. - ✓ Управление сообществом — для синхронизации настроек (опционально).

1. Нажмите Создать. ВК покажет токен — длинная строка букв (vk1.a.xxx...).
2. Скопируйте сразу — после закрытия окна показывается только маска vk1.a.****. Если потеряли — создайте новый, старый отзовите.

Настройка Callback API

Самый сложный шаг — есть обмен подтверждениями.

1. На той же странице Работа с API → Callback API.
2. Версия API: 5.131 или выше.
3. Вкладка Серверы → Добавить сервер.
4. В CRMservice откройте Настройки → Интеграции → Мессенджеры → ВКонтакте.
5. Сначала заполните Access Token (шаг 2) и Сохраните — без этого CRM не сгенерирует уникальный вебхук URL.
6. CRM покажет:

- URL вебхука вида https://crm.<ваш-домен>/api/v1/webhooks/vk/. - Строка подтверждения (4-8 символов) — это специальный код, который наш сервер вернёт при первом запросе ВК.

1. В кабинете ВК:

- Адрес: вставьте URL вебхука из CRM. - Строка для подтверждения: вставьте код из CRM.

1. Нажмите Подтвердить в ВК. Если URL и код совпадают — ВК покажет «Подтверждение прошло успешно».

Подписка на типы событий

В ВК на той же странице Callback API → Типы событий:

• ✓ Входящее сообщение (message_new) — обязательно.
• ✓ Редактирование сообщения (message_edit).
• ✓ Отметка о прочтении сообщения (message_read) — опционально, для аналитики.
• ✓ Разрешение от пользователя (message_allow) — клиент разрешил вам писать первым.
• ✓ Запрет от пользователя (message_deny) — клиент запретил вам писать.

Тест

1. Напишите в ваше сообщество с другого аккаунта ВК (не админа).
2. В CRM → Сообщения → новый диалог появится через 1–3 секунды.
3. Ответьте — клиент получит сообщение от сообщества.

Подключение в CRMservice (финальное)

1. Настройки → Интеграции → Мессенджеры → Добавить канал → ВКонтакте.
2. Уже заполнено: Access Token, channel_id.
3. Укажите ID сообщества (короткое имя или числовой ID — узнать через vk.com/club).
4. Сохранить.

Возможные проблемы

• «Подтверждение не проходит» — URL в кабинете ВК не совпадает с тем что в CRM (опечатка) или строка подтверждения скопирована неточно. Сравните посимвольно.
• «Не приходят сообщения» — Callback API в ВК выключен или нет подписки на message_new. Проверьте.
• «Access denied» — токен сообщества истёк или был отозван. Создайте новый.
• «Лимит 20 сообщений / сек» — VK ограничивает скорость. Если шлёте массовые уведомления — CRM делает паузы автоматически.

Что делает ВК и что — CRM

ВК	CRMservice
Принимает сообщение от клиента	Получает вебхук, создаёт лид (если новый клиент) и диалог
Хранит историю переписки на своём сервере (резерв)	Хранит копию в chat_messages (своя БД)
Передаёт фото/документы через свой API	Скачивает к себе если опция «Сохранять медиа» включена
Применяет свои лимиты	Складывает превышения в очередь, ретраит