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

Боты работают только в подключённых сообществах: в них копится база подписчиков и через них идут рассылки. Подключение занимает пару минут.

Шаг 1. Войдите через VK ID

Авторизация в botvk — только через VK ID (кнопка входа на странице логина ведёт на id.vk.com). Входа по email и паролю нет.

При первом входе рабочее пространство (workspace) создаётся автоматически — название берётся из вашего имени, отдельного шага «создайте пространство» нет. Вместе с workspace сразу создаётся CRM-воронка по умолчанию.

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

Откройте раздел «Сообщества» в сайдбаре.
В секции «Доступные для подключения» найдите нужное сообщество — здесь показываются сообщества, где вы администратор.
Нажмите «Подключить» — откроется окно OAuth ВКонтакте.
Подтвердите доступ. VK запросит права: manage, messages, photos, docs, wall, stories, app_widget.

Токен сообщества сохраняется на сервере в зашифрованном виде (AES-GCM). Если нужного сообщества нет в списке — нажмите «Обновить», чтобы перезапросить список из VK.

Настраивать Callback API в админке сообщества не нужно. Платформа получает события через VK Long Poll — собственный серверный демон botvk опрашивает каждое подключённое сообщество. Достаточно, чтобы в сообществе были включены сообщения.

Шаг 3. Проверьте, что всё работает

Бот начнёт отвечать после трёх условий:

Сообщество подключено (зелёный бейдж «Подключено»).
Бот привязан к этому сообществу.
Сценарий бота опубликован.

Лимиты сообществ по тарифам

Тариф	Сообществ
Free	2
Старт	5
Про	15
Бизнес и выше	безлимит

Лимит проверяется при завершении подключения. Подробнее — в разделе Тарифы и оплата.

Если появился бейдж «Token revoked»

Красный бейдж «Token revoked» означает, что токен сообщества отозван (например, после смены прав администратора в VK). Бот в этом сообществе работать не сможет — переподключите сообщество: нажмите «Подключить» и заново пройдите OAuth.

Отключение сообщества кнопкой «Отключить» безопасно для данных: подписчики и переписка сохраняются.