Главная · Справка · Подключение бота ВКонтакте: в один клик или по ключу сообщества

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

Бот ВКонтакте подключается за пару минут. Сначала в сообществе включаются сообщения и возможности ботов — это делаете вы. Потом в ЧБТ: кнопкой «Подключить через ВКонтакте» (вход через ВКонтакте, без ключей) или по ключу доступа сообщества. Callback API ЧБТ в обоих случаях настраивает сам: адрес сервера, строку подтверждения и секрет вводить не нужно. Ниже — шаги, что ЧБТ делает при подключении и как по признакам найти ошибку.

Что понадобится

• Права администратора сообщества. Подключить сообщество может только его администратор: ВКонтакте покажет в списке лишь те сообщества, где вы администратор, а ключи доступа создаются в «Управлении», которое открыто только администраторам.
• Бот в ЧБТ. Подойдёт любой тариф, включая Бесплатный: за канал ВКонтакте отдельно не платят. Если в боте уже работает Telegram или MAX, ВКонтакте добавляется к нему же, и сценарий остаётся общим.

Шаг 1. Сообщения и возможности ботов

1. «Управление» → «Сообщения» → переключатель «Сообщения сообщества» в положение «Включены». Пока он выключен, в сообществе нет кнопки «Написать», и в ЧБТ не приходит ни одного сообщения.
2. В том же разделе откройте «Настройки для бота»: «Возможности ботов» — «Включены», плюс галочка «Добавить кнопку «Начать»».

Зачем второй пункт. Кнопки под ответами ЧБТ отправляет как клавиатуру бота, а ВКонтакте принимает её только от сообществ с включёнными возможностями ботов: без них текстовые ответы уходят, а сообщения с кнопками — нет. Кнопка «Начать» к тому же даёт вход в сценарий: её нажатие ЧБТ считает командой /start.

Шаг 2. Подключение кнопкой «Подключить через ВКонтакте»

1. В боте ЧБТ откройте «Каналы» и на карточке «ВКонтакте» нажмите «Подключить через ВКонтакте».
2. Войдите через VK ID той страницей, которая администратор сообщества.
3. ЧБТ покажет сообщества, где вы администратор. Выберите нужное и нажмите «Подключить».
4. ВКонтакте спросит разрешение для сообщества — нажмите «Разрешить». Доступ к сообщениям нужен, чтобы бот отвечал, к управлению — чтобы ЧБТ сам настроил приём событий, к фотографиям и файлам — для постов с картинками из раздела «Редакция».
5. ЧБТ настроит Callback API и вернёт вас в «Каналы»: у сообщества появится строка со статусом «Работает».

Если вместо списка ЧБТ пишет «ВКонтакте не показал список ваших сообществ», вставьте ссылку на сообщество, например vk.com/club123, — дальше ВКонтакте так же спросит разрешение. Если пишет «Сообществ, где вы администратор, не нашлось», вы вошли не той страницей: попросите владельца назначить вас администратором или войдите страницей владельца.

Шаг 2, другой путь. Подключение по ключу сообщества

Подходит, если подключает не администратор, а коллега, которому администратор передал ключ.

1. Во ВКонтакте: сообщество → «Управление» → «Работа с API» → «Ключи доступа» → «Создать ключ».
2. Отметьте два права: «Сообщения сообщества» — чтобы бот отвечал, и «Управление сообществом» — чтобы ЧБТ сам настроил приём событий. Остальные боту не нужны.
3. Скопируйте ключ — он начинается с vk1.a..
4. В ЧБТ: «Каналы» → карточка «ВКонтакте» → «Подключить по ключу сообщества», вставьте ключ и нажмите «Подключить по ключу».

ЧБТ сразу проверит ключ и его права. Если права не хватает, канал не подключится, а ошибка назовёт, какое право отметить. В кабинете ключ хранится в зашифрованном виде и больше не показывается ни вам, ни команде.

Что ЧБТ делает при подключении

1. Узнаёт сообщество по ключу и проверяет, что у ключа есть права на сообщения и управление.
2. Заводит Callback-сервер «ЧБТ» в «Управлении» → «Работа с API» → «Callback API»: адрес вида https://app.chbt.io/webhook/vk/57, где число — номер канала в ЧБТ, строку подтверждения и случайный секрет. Если сервер с этим адресом уже есть, ЧБТ его перенастраивает, а не создаёт второй.
3. Включает версию API 5.199 и события: входящие сообщения, нажатия кнопок, разрешение и запрет сообщений от сообщества, а также комментарии к постам и товарам — их использует модерация комментариев в «Редакции».
4. Ждёт подтверждения от ВКонтакте. Статус «Работает» канал получает, только когда ВКонтакте подтвердил сервер. Не подтвердил — статус «Ошибка» с причиной.

После этого каждое событие ЧБТ сверяет по секрету, сохраняет в очередь и только потом отвечает ВКонтакте. Повтор того же события сценарий второй раз не запускает. Нажатие кнопки ЧБТ «отпускает» сразу, ещё до запуска сценария, чтобы у человека не крутился индикатор ожидания. Ответ уходит от имени сообщества: текст и до 10 кнопок, по две в ряд.

Проверка после подключения

1. Убедитесь, что сценарий включён: в «Сценариях» на его карточке плашка «Включён», а не «Черновик».
2. С личной страницы — своей или коллеги, не из интерфейса администратора сообщества — откройте сообщения сообщества. Если эта страница сообществу раньше не писала, увидите кнопку «Начать»: нажмите её, затем отправьте любой текст.
3. В ЧБТ откройте «Диалоги». Правильная картина: диалог подписан именем и фамилией этой страницы, в нём ваши сообщения и ответы бота без пометки «не доставлено». Нажмите кнопку-ветку в ответе — индикатор на кнопке гаснет сразу, следом приходит продолжение.

Если что-то пошло иначе, найдите свой признак в таблице ниже. Полный чеклист по порядку, вместе со сценарием и тарифом, — «Бот ВКонтакте молчит».

Ошибки подключения и их признаки

Что видно	Почему	Что сделать
«Неверный ключ сообщества или нет права «Управление»»	Ключ удалён, скопирован не целиком или выдан другим сообществом	Подключить кнопкой или создать новый ключ с двумя правами
«У ключа нет права «Сообщения сообщества»» или «…«Управление сообществом»»	При создании ключа не отмечено право	Создать ключ заново с обоими правами и вставить его через «Изменить ключ» в строке канала
«Не удалось настроить приём событий» или «VK не подтвердил callback»	ВКонтакте не дал завести или подтвердить сервер — например, в Callback API уже много старых серверов	Удалить лишние серверы в «Управлении» → «Работа с API» → «Callback API» и нажать «Переустановить webhook» в строке канала
Канал «Работает», в «Диалогах» пусто	Выключены «Сообщения сообщества» или вы пишете из интерфейса администратора, а не с личной страницы	Шаг 1; проверка — с личной страницы
Сообщение в «Диалогах» есть, у ответа бота «не доставлено»	Человек запретил сообщения от сообщества или ключ отозван	Навести на пометку и прочитать текст ошибки; ключ отозван — подключить заново
Статус «Ошибка» с текстом «токен бота отклонён (401 Unauthorized)»	Ключ удалён или отозван во ВКонтакте. ЧБТ ставит этот статус при первой неудачной отправке и пишет владельцу на почту	Подключить кнопкой заново или вставить новый ключ через «Изменить ключ»
Текстовые ответы приходят, сообщения с кнопками — нет	Выключены «Возможности ботов»	Шаг 1
Нет кнопки «Начать»	Не отмечено «Добавить кнопку «Начать»» или страница уже писала сообществу	Шаг 1; тест со страницы, которая сообществу ещё не писала

Полный чеклист по порядку, вместе со сценарием и тарифом, — «Бот ВКонтакте молчит».

Смена ключа и переподключение

Новый ключ. В строке канала в «Каналах» нажмите «Изменить ключ» и вставьте новый. Канал, его номер, адрес и переписка остаются прежними. Если новый ключ не подошёл, ЧБТ вернёт старый, и канал продолжит работать.

«Переустановить webhook». Кнопка в строке канала заново настраивает Callback API по сохранённому ключу: сервер, секрет, версию и события. Нажимайте её, если в сообществе кто-то удалил или поменял сервер «ЧБТ».

Удаление канала. Переписка удалённого канала остаётся в «Диалогах» для чтения, контакты и их теги — тоже. Сервер «ЧБТ» во ВКонтакте при этом остаётся — его можно удалить вручную в «Callback API».

Частые вопросы

Нужно ли самому настраивать Callback API?
Нет. И при подключении кнопкой, и по ключу ЧБТ сам заводит в сообществе сервер, строку подтверждения, секрет, версию API и нужные события. Вам остаётся включить сообщения и возможности ботов в «Управлении» → «Сообщения».

Канал в статусе «Работает», а бот молчит. Почему?
Статус «Работает» значит, что ВКонтакте подтвердил сервер ЧБТ. Если бот молчит, чаще всего выключены «Сообщения сообщества», сценарий в черновике или вы пишете из интерфейса администратора. Проверьте сообщением с личной страницы и смотрите «Диалоги».

Бот отвечает на комментарии?
Нет, бот сценариев работает только в сообщениях сообщества. Комментарии к постам и товарам ЧБТ получает для модерации в разделе «Редакция».

Что выбрать: кнопку или ключ?
Кнопку, если вы администратор сообщества: не нужно создавать ключ и отмечать права. Ключ — если подключает коллега без прав администратора, которому администратор передал ключ.

Создать бота бесплатно

Канал VKБот молчит: чеклистБот для сообщества: разборСбор заявок