Инструкция для кабинета Чат-онлайн: подключите сообщения сообщества ВКонтакте. Посетитель пишет вам в личные сообщения группы, а вы отвечаете из раздела «Диалоги» — ответ уходит обратно во ВКонтакте.
1. Включите сообщения в сообществе
- Откройте ваше сообщество ВКонтакте под учётной записью администратора.
- Перейдите в Управление → Сообщения.
- Включите «Сообщения сообщества» (кнопка «Написать сообществу» на странице группы).
- При необходимости разрешите писать всем пользователям или настройте приветственное сообщение.
2. Создайте ключ доступа
- В сообществе: Управление → Работа с API → Ключи доступа.
- Нажмите «Создать ключ».
- Отметьте доступ «Сообщения сообщества» (и при необходимости «Управление сообществом» для проверки).
- Скопируйте ключ — он понадобится в кабинете Чат-онлайн.
Также запишите числовой ID группы (без минуса) — его видно в адресе страницы или в настройках сообщества.
3. Настройте Callback API
- В том же разделе API откройте Callback API.
- Сначала в кабинете Чат-онлайн (шаг ниже) скопируйте Адрес сервера (Callback URL).
- В ВК нажмите «Добавить сервер» и вставьте этот URL.
- ВК отправит запрос подтверждения — скопируйте строку подтверждения из настроек ВК и вставьте её в поле «Строка подтверждения» в кабинете Чат-онлайн.
- Укажите секретный ключ сервера в ВК и тот же ключ в кабинете (поле «Секретный ключ Callback API»).
- В разделе Типы событий включите «Входящее сообщение» (
message_new). - Нажмите «Сохранить» в настройках ВК. Статус сервера должен стать зелёным.
4. Укажите данные в кабинете Чат-онлайн
- Откройте личный кабинет → выберите сайт.
- Перейдите в Интеграция → ВКонтакте.
- Заполните ID группы, ключ доступа, строку подтверждения и секретный ключ.
- Включите переключатель «Включено» и нажмите «Сохранить».
- Нажмите «Проверить подключение» — система проверит ключ и загрузит существующие диалоги.
- При необходимости нажмите «Загрузить диалоги из ВК» для повторной синхронизации.
5. Где пишет посетитель
Посетитель общается с вами во ВКонтакте, а не на сайте:
- На странице сообщества — кнопка «Написать сообщение» / «Написать».
- В мобильном приложении ВК — раздел сообщений с вашим сообществом.
- После ответа из кабинета Чат-онлайн он увидит ваш ответ в том же чате ВК.
На сайте виджет может предлагать канал «ВКонтакте», но для полноценной двусторонней переписки через API нужно именно подключение сообщества по этой инструкции.
6. Где смотреть переписку
- Диалоги — все чаты ВК в общем списке с фильтром «ВК» и бейджем канала.
- CRM — автоматически создаётся лид/сделка с источником «ВКонтакте».
- Ответ из диалога отправляется посетителю в личные сообщения группы ВК.
Совет: если новые сообщения не приходят, проверьте в Callback API, что сервер подтверждён, событие message_new включено, а URL совпадает с адресом из кабинета.