ЧБТ ЧБТ конструктор чат-ботов
Создать бота
Возможности
Продавцам Магазин в боте ИИ-продавец Wildberries Интернет-магазин QR-код на вкладыш
Мессенджеры Telegram MAX ВКонтакте Чат на сайте
Шаблоны Тарифы Блог Помощь
Войти Создать бота

Главная · Блог · Бот ВКонтакте для сообщества: от подключения до первого сценария

Бот ВКонтакте для сообщества: от подключения до первого сценария

· обновлено · Команда ЧБТ · VK

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

Что бот ВКонтакте делает — и чего не делает

Бот в ЧБТ работает в сообщениях сообщества: человек открывает диалог с вашей группой или пабликом, пишет — бот отвечает от имени сообщества. Это тот же диалог, который сейчас ведёт администратор, только первую линию берёт сценарий.

Типовые задачи, которые закрываются в первую неделю:

  • ответы на повторяющиеся вопросы — цены, адрес, график, наличие — по ключевым словам или кнопками;
  • сбор заявок: имя и телефон в блоке «Сбор данных» с проверкой формата, заявка — в «Контактах» и письмом вам;
  • запись на услугу или пробное занятие: услуга кнопкой, время текстом, подтверждение администратором;
  • дежурный ответ ночью: «Получили, ответим утром» — через «Условие» по времени суток;
  • передача оператору: блок «Оператор» отдаёт диалог человеку в раздел «Диалоги», бот замолкает.

Чего бот не делает, чтобы не было ложных ожиданий. Он не отвечает на комментарии под постами и не пишет на стене — только личные сообщения сообщества. Не работает от личной страницы — нужно именно сообщество. Не отправляет фото и файлы: в VK, как и в Telegram и MAX, ЧБТ шлёт текст и кнопки, документы даёт ссылкой. И не пишет первым тем, кто сообществу не писал, — это правило платформы, общее для всех ботов.

Если вы ещё не решили, нужен ли вам бот вообще и с какой задачи начинать, общий разбор — в статье как создать чат-бота без программиста. Здесь — только ВКонтакте.

До начала: что должно быть включено в сообществе

Три настройки, без которых дальше ничего не заработает. Все — в разделе «Управление» вашего сообщества, нужны права администратора (редактора недостаточно: подключить сообщество к боту может только администратор).

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

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

Подключение в ЧБТ: кнопкой или по ключу сообщества

Удобнее всего — кнопкой, без ключей и копирования строк.

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

Вы вернётесь в «Каналы», и у сообщества появится строка со статусом «Работает». Если ВКонтакте не показал список сообществ, вставьте ссылку на сообщество вида vk.com/club123.

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

Ключ не пересылайте в чатах и не храните в общих документах: в ЧБТ он хранится зашифрованным и больше не показывается. Заменить его можно через «Изменить ключ» в строке канала — номер канала и переписка останутся прежними.

Callback API: ЧБТ настраивает его сам

Callback API — способ, которым ВКонтакте сообщает ЧБТ о новых сообщениях и нажатиях кнопок. Вписывать адрес, строку подтверждения и секрет вручную не нужно — при подключении ЧБТ делает всё сам:

  • заводит в «Работе с API» → «Callback API» сервер «ЧБТ» с адресом вида https://app.chbt.io/webhook/vk/57, строкой подтверждения и случайным секретом; если сервер с таким адресом уже есть, перенастраивает его;
  • включает версию API 5.199 и нужные события: входящие сообщения, нажатия кнопок, разрешение и запрет сообщений, а также комментарии к постам и товарам — их использует модерация комментариев в «Редакции», бот на комментарии не отвечает;
  • ставит статус «Работает», только когда ВКонтакте подтвердил сервер; не подтвердил — статус «Ошибка» с причиной.

Если в сообществе удалят или поменяют сервер «ЧБТ», нажмите «Переустановить webhook» в строке канала — ЧБТ заново настроит сервер, секрет, версию и события по сохранённому ключу.

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

Первый сценарий: шаблон, триггеры и особенности входа в VK

Сценарий в ЧБТ не привязан к каналу: тот же набор блоков работает во ВКонтакте, Telegram и MAX. Но вход у VK свой, и это надо учесть в триггерах.

С чего начать. Для сообщества, куда пишут «сколько стоит», возьмите шаблон «Автоответчик FAQ»: ключевые слова по ценам и графику, иначе — оператор. Для сообщества, где главное — заявки, — «Сбор заявок»: имя, телефон, благодарность. Шаблон открывается кнопкой «Использовать шаблон» и сразу оказывается в разделе «Сценарии», где его можно править в режиме «Шаги» (линейно, доступен на Бесплатном тарифе) или на «Холсте» (Базовый и выше).

Три триггера, которые должны быть в VK-сценарии.

  • «Команда /start» — срабатывает на кнопку «Начать». ВКонтакте присылает служебное событие, ЧБТ превращает его в /start. Это вход для тех, кто открыл диалог впервые.
  • «Ключевое слово» в режиме «содержит» — «цена», «стоимость», «адрес», «график». Люди во ВКонтакте пишут в сообщество как человеку, длинными фразами: «здравствуйте, подскажите пожалуйста сколько стоит стрижка». Режим «точно» здесь почти бесполезен.
  • «Любое сообщение» — обязательный. У аудитории VK нет привычки к командам, никто не будет писать /start. Если человек написал что-то, не попавшее в ключевые слова, сценарий должен всё равно ответить — меню кнопками или сразу передачей оператору. Пустой ответ в VK выглядит как игнор от сообщества.

Имя подтягивается само. При первом сообщении ЧБТ запрашивает у ВКонтакте имя и фамилию пользователя и записывает в карточку контакта — переменная {{name}} в сообщениях заполнится без вопроса «как вас зовут». Спрашивать имя блоком «Сбор данных» во ВКонтакте обычно не нужно; телефон — нужно, у VK его нет.

Если планируете выдавать материал по слову — «прайс», «чеклист», «промокод» — механика та же, что в Telegram и MAX: триггер «Ключевое слово» → «Сообщение» со ссылкой на материал → действие «Добавить тег». Готовый скелет под это — шаблон «Выдача лид-магнита».

Кнопки во ВКонтакте: 10 штук, по 2 в ряд, 40 символов

Кнопки в блоке «Сообщение» ЧБТ раскладывает под сообщением во ВКонтакте автоматически. Правила площадки, в которые это упирается:

  • До 10 кнопок под одним сообщением. Если в блоке их больше, лишние не отобразятся — делите меню на два шага: «Услуги» → конкретные услуги.
  • По 2 в ряд, то есть максимум 5 рядов. Восемь кнопок — четыре аккуратных ряда; семь — последняя останется одна в ряду, это нормально.
  • Подпись до 40 символов. Более длинная будет обрезана. Пишите глаголами: «Записаться», «Узнать цену», «Позвать человека».
  • Два типа кнопок. Кнопка-ссылка открывает URL — сайт, карту, прайс на диске. Кнопка-ветка запускает продолжение сценария (в ЧБТ это триггер «Нажатие кнопки» или следующий блок). Событие нажатий ЧБТ включает в Callback API сам, а чтобы сообщения с кнопками вообще доходили, в сообществе должны быть включены «Возможности ботов» — см. выше.

Есть одна деталь поведения, о которой стоит знать. Когда человек нажимает кнопку-ветку, ВКонтакте показывает на ней индикатор ожидания, пока сервер не ответит. ЧБТ снимает его сразу при получении события, поэтому кнопка не «висит» — но если сценарий выключен или webhook сломан, пользователь увидит именно бесконечное ожидание на кнопке. Это удобный симптом при диагностике: «крутится и не отвечает» почти всегда означает проблему на стороне подключения, а не сценария.

И правило дизайна, не зависящее от платформы: последняя кнопка в любом меню — выход к человеку. «Оператор», «Задать свой вопрос», «Позвать администратора» — как назвать, неважно; важно, чтобы она была. Куда ведёт эта кнопка и как оператор подхватывает диалог, разобрано в статье бот или оператор: передача диалога.

Особенности VK, которые влияют на сценарий

Бот во ВКонтакте живёт по правилам ВКонтакте, и часть из них отличается от того, к чему привыкли владельцы Telegram-ботов.

  • Пользователь может запретить сообщения от сообщества. Тогда бот ему не ответит, и в диалоге это будет выглядеть как молчание. Повлиять на это нельзя — только попросить разрешить сообщения на странице сообщества.
  • Ответы администратора из интерфейса VK бот не видит. Если ваш сотрудник отвечает клиенту прямо во ВКонтакте, а не из «Диалогов» ЧБТ, сценарий об этом не узнает и может продолжить свою ветку поверх живого разговора. Договоритесь: пока бот включён, отвечаем из кабинета. Блок «Оператор» для этого и нужен — он останавливает бота в диалоге.
  • Лимиты на отправку. ВКонтакте ограничивает число сообщений от сообщества в секунду. Для диалогов это не проблема; для рассылок по большой базе (раздел «Рассылки», Базовый тариф и выше) ЧБТ шлёт очередью с задержками — тысяча сообщений уйдёт за минуту-две, не мгновенно.
  • Подписка на сообщество и переписка — разные вещи. Подписчик паблика не является контактом бота, пока не написал в сообщения. База для рассылок через бота — это те, кто писал, а не число подписчиков в шапке.
  • Одно подключение — одно сообщество. Канал в ЧБТ связан с конкретным сообществом; второе сообщество подключается отдельно — кнопкой или своим ключом.

Что общее с другими каналами: карточки контактов из VK попадают в те же «Контакты», диалоги — в тот же инбокс, сделки — в ту же CRM. Если у вас уже есть Telegram-бот на ЧБТ, ВКонтакте подключается к нему как ещё один канал, а не как отдельный проект. Обзор канала и его возможностей — на странице чат-бота ВКонтакте.

Если бот молчит: семь проверок

Список составлен по обращениям в поддержку — в таком порядке причины и встречаются.

  1. Сообщения сообщества выключены или выключены «Возможности ботов». Проверьте «Управление» → «Сообщения».
  2. Канал в «Каналах» со статусом «Ошибка». Рядом написана причина. «VK не подтвердил callback» или «Не удалось настроить приём событий» — удалите лишние старые серверы в «Работе с API» → «Callback API» и нажмите «Переустановить webhook» в строке канала.
  3. Сервер «ЧБТ» удалили или поменяли во ВКонтакте. Событий нет, а в ЧБТ ничего не менялось — нажмите «Переустановить webhook».
  4. Ключ отозван или удалён. Статус «Ошибка» с текстом «токен бота отклонён (401 Unauthorized)», владельцу приходит письмо. Подключите сообщество кнопкой заново или вставьте новый ключ с двумя правами через «Изменить ключ».
  5. Сценарий выключен или в нём нет триггера «Любое сообщение». Написали «привет» — ни одно ключевое слово не совпало, а поймать нечем. Добавьте catch-all.
  6. Исчерпан лимит Бесплатного тарифа — 30 диалогов в месяц на проект. После 30 собеседников за месяц с теми, кто уже писал в этом месяце, бот разговаривает как обычно, а новым вместо сценария отвечает служебной фразой о лимите, и их сообщения в «Диалоги» не попадают. Сколько диалогов набралось, показывает счётчик «N из 30» в карточке тарифа на странице «Обзор» бота и в разделе «Оплата». Лимит снимается на Базовом (650 ₽ за бота в месяц).
  7. Пользователь запретил сообщения от сообществ или вы пишете из интерфейса администратора. Проверьте с другой, личной страницы.

Порядок отладки: сначала «Проверить сценарий» в редакторе — он покажет, что логика работает без ВКонтакте; потом сообщение в сообщество с личной страницы. Если первое работает, а второе нет — проблема в подключении, пункты 1–4. Полный чеклист — «Бот ВКонтакте молчит».

Что подключать следующим

Первый сценарий — это автоответы и заявки. Когда он проработал неделю и вы увидели в «Диалогах», о чём люди спрашивают на самом деле, есть три логичных шага.

  • Теги и сегменты. Действие «Добавить тег» на ветках («спросил-цену», «записался», «ждёт-оператора») — и через месяц в «Контактах» видно, чего хотят подписчики. По тегам запускаются рассылки — например, «свободное окно завтра в 15:00» тем, кто интересовался записью.
  • ИИ-агент на свободные вопросы. На Базовом тарифе в сценарий добавляется блок «ИИ-агент»: вы описываете компанию, услуги и цены обычным текстом в разделе «ИИ-агенты», и агент отвечает на вопросы, не попавшие в ключевые слова, а при неуверенности зовёт оператора. Ответ агента на модели по умолчанию — один ИИ-кредит, на мощных моделях дороже; в Базовый входит 150 кредитов в месяц.
  • Второй канал. Если у вас есть аудитория в Telegram или MAX, подключите их в тот же проект: сценарий, контакты и инбокс станут общими, а различия в текстах — если понадобятся — разводятся блоком «Условие» по каналу.

На Бесплатном тарифе всё описанное в статье — подключение ВКонтакте, шаблон, кнопки, оператор в «Диалогах» — доступно без карты; ограничение одно — 30 диалогов в месяц. Этого достаточно, чтобы понять, снимает ли бот нагрузку с администратора сообщества. Создать бота для сообщества ВКонтакте →

Чат-бот ВКонтакте для сообществаСправка: подключение ВКонтактеБот ВКонтакте молчитШаблон «Сбор заявок»Шаблон «Автоответчик FAQ»Передача диалога оператору

Ещё в блоге