VK
Обновлено 11 октября 2026 г.
На этой странице
Для личных диалогов выберите «Личный профиль». Если клиенты пишут сообществу, подключите «Сообщество»: оператор будет отвечать от его имени.
Перед подключением
- Личный профиль: возможность войти в нужный аккаунт VK и подтвердить разрешения.
- Сообщество: права администратора и включённые сообщения сообщества.
Откройте нужную группу в Чатве → «Каналы» → карточку канала → «Подключить». При первом подключении пройдите подсказки кнопкой «Далее». В мобильном приложении тот же мастер доступен в онбординге и разделе «Каналы».
Выберите способ подключения
Личный профиль
Выберите «Личный профиль» → «Войти через VK»
Войдите в нужный аккаунт и прочитайте запрашиваемые разрешения. Разрешите доступ, чтобы Чатва могла принимать сообщения и отправлять ответы.
В веб-кабинете скопируйте адрес после входа
После разрешения браузер может показать пустую страницу oauth.vk.com/blank.html. Скопируйте её адрес целиком, включая часть после #, в «Адрес страницы после входа» → «Подключить».
В приложении дождитесь завершения встроенного входа
Чатва обычно забирает данные входа сама. Если окно не сработало, нажмите «Вставьте ссылку вручную» и выполните шаг с полным адресом страницы.
Сообщество: автоматическое подключение
Сначала включите сообщения в настройках сообщества VK. В Чатве выберите «Сообщество». Если доступен вход через VK ID, укажите ссылку на сообщество или его ID, нажмите «Подключить» в вебе / «Подключить через VK ID» в приложении и разрешите доступ. Ключ, подтверждение и вебхук настраиваются автоматически.
Сообщество: подключение вручную
Включите сообщения и получите ключ VK
Откройте своё сообщество как администратор
В списке сообществ VK выберите нужное сообщество. Нажмите «Управление» → «Сообщения», включите сообщения сообщества и сохраните. Справка VK о сообщениях.
VK: кнопка «Управление» на странице сообщества. Скриншот из официальной справки.
Источник: VK · Ключ доступа сообщества ↗Создайте ключ для сообщений
В том же сообществе VK откройте «Управление» → «Дополнительно» → «Работа с API» → «Ключи доступа» → «Создать ключ». Разрешите доступ к сообщениям сообщества, нажмите «Создать» и подтвердите действие способом, который предложит VK. Инструкция VK.
Скопируйте полный ключ
На вкладке «Ключи доступа» нажмите «Показать» у созданного ключа и скопируйте его целиком. Это ключ сообщества; токен личного профиля сюда не подходит. Где находятся ключи.
VK: «Работа с API» → «Ключи доступа» → «Создать ключ». Секрет скрыт; набор прав на примере не нужно повторять целиком.
Источник: VK · Получение ключа ↗Настройте Callback API в VK
Добавьте сервер Callback API
В «Работа с API» откройте «Callback API» → «Добавить сервер». Назовите его «Чатва» и перенесите адрес вебхука из формы нужной группы Чатвы в поле «Адрес». Навигация в VK.
Перенесите строку подтверждения и ID
Под полем адреса найдите «Строка, которую должен вернуть сервер». Это значение для поля «Строка подтверждения» в Чатве. В примере запроса рядом group_id показан числовой ID сообщества. Используйте данные своего сервера, не цифры со скриншота. Описание полей VK.
Задайте секрет и сначала сохраните подключение
В поле «Секретный ключ» укажите собственную случайную строку. Точно такое же значение внесите в Чатву вместе с ID, ключом доступа и строкой подтверждения. Сначала сохраните эти поля в Чатве, затем вернитесь в настройки Callback API и подтвердите адрес сервера.
Фрагмент официального примера VK: адрес, строка подтверждения и секретный ключ. Секретные значения скрыты; внешний вид кабинета может отличаться.
Источник: VK · Подключение Callback API ↗После подтверждения откройте «Типы событий» и включите входящие сообщения (message_new). Если сообщения не появляются, проверьте вкладку «Запросы» этого сервера. События и диагностика VK.
Проверьте входящее сообщение и ответ
Напишите с другого аккаунта
Отправьте подключённому профилю или в сообщения сообщества сообщение «Проверка подключения». Используйте другой аккаунт, чтобы проверить именно входящее обращение клиента.
Найдите диалог в Чатве
Откройте «Инбокс» нужной группы, проверьте канал и отправителя. Если установлен фильтр по оператору или статусу, временно переключитесь на все диалоги.
Ответьте из инбокса
Отправьте «Сообщение получили» и убедитесь на стороне клиента, что ответ пришёл от нужного номера, бота или страницы. Отметка подключения сама по себе не проверяет доставку в обе стороны.
Что приходит в инбокс
Для сообщества подключаются личные сообщения, а не комментарии к записям. Для личного профиля доступны личные диалоги; недавняя история может загружаться частично. Всегда проверяйте работу новым сообщением.
Если не получилось
| Что произошло | Что проверить |
|---|---|
| Пустая страница после входа | В веб-сценарии это ожидаемый этап: скопируйте полный адрес страницы в Чатву. |
| Токен личного профиля не подошёл | Выполните вход заново и скопируйте адрес целиком. Не обрезайте токен по точкам или после #. |
| VK не подтверждает Callback URL | Сначала сохраните строку подтверждения и секрет в Чатве. Проверьте ID сообщества и URL выбранной группы. |
| Сообщество подключено, входящих нет | Включите сообщения сообщества и событие message_new, затем проверьте статус Callback-сервера в VK. |