Главная · Блог · Бот ВКонтакте для сообщества: от ключа доступа до первого сценария
Бот ВКонтакте для сообщества: от ключа доступа до первого сценария
Сообщество ВКонтакте — это уже собранная аудитория: люди подписались, видят посты и пишут в личку сообщества с вопросами «сколько стоит» и «работаете ли в воскресенье». Бот отвечает на эти сообщения вместо администратора, собирает заявки и передаёт сложное человеку. Подключается он не через приложение, а через ключ доступа сообщества и Callback API — звучит технически, но занимает двадцать минут и не требует кода. Ниже — весь путь с контекстом: что должно быть включено в сообществе, какие права отметить у ключа, в каком порядке заполнять поля в ЧБТ и во ВКонтакте, как собрать первый сценарий и чем бот VK отличается от Telegram-бота.
Что бот ВКонтакте делает — и чего не делает
Бот в ЧБТ работает в сообщениях сообщества: человек открывает диалог с вашей группой или пабликом, пишет — бот отвечает от имени сообщества. Это тот же диалог, который сейчас ведёт администратор, только первую линию берёт сценарий.
Типовые задачи, которые закрываются в первую неделю:
- ответы на повторяющиеся вопросы — цены, адрес, график, наличие — по ключевым словам или кнопками;
- сбор заявок: имя и телефон в блоке «Сбор данных» с проверкой формата, заявка — в «Контактах» и письмом вам;
- запись на услугу или пробное занятие: услуга кнопкой, время текстом, подтверждение администратором;
- дежурный ответ ночью: «Получили, ответим утром» — через «Условие» по времени суток;
- передача оператору: блок «Оператор» отдаёт диалог человеку в раздел «Диалоги», бот замолкает.
Чего бот не делает, чтобы не было ложных ожиданий. Он не отвечает на комментарии под постами и не пишет на стене — только личные сообщения сообщества. Не работает от личной страницы — нужно именно сообщество. Не отправляет фото и файлы: в VK, как и в Telegram и MAX, ЧБТ шлёт текст и кнопки, документы даёт ссылкой. И не пишет первым тем, кто сообществу не писал, — это правило платформы, общее для всех ботов.
Если вы ещё не решили, нужен ли вам бот вообще и с какой задачи начинать, общий разбор — в статье как создать чат-бота без программиста. Здесь — только ВКонтакте.
До начала: что должно быть включено в сообществе
Три настройки, без которых дальше ничего не заработает. Все — в разделе «Управление» вашего сообщества, нужны права администратора (редактора недостаточно: он не создаёт ключи доступа).
- «Сообщения» включены. «Управление» → «Сообщения» → «Сообщения сообщества: Включены». Если они выключены, у людей нет кнопки «Написать», а Callback API не пришлёт ни одного события.
- «Возможности ботов» включены. Там же, в «Настройках для бота»: включите возможности ботов и отметьте «Добавить кнопку «Начать»». Именно эта кнопка даст боту точку входа: по нажатию ВКонтакте отправляет служебное событие, и ЧБТ запускает сценарий как по команде
/start. - Приветственное сообщение сообщества — отключите или приведите в соответствие с ботом. ВКонтакте умеет показывать своё приветствие при открытии диалога; если оно говорит «Напишите, администратор ответит», а бот следом предлагает кнопки, человек путается. Пусть первое слово будет за сценарием.
Ещё один момент, о котором забывают: у сообщества должен быть человек, который будет отвечать на то, что бот передал оператору. Инбокс ЧБТ — раздел «Диалоги» — покажет такие обращения, но отвечать в них будете вы или ваш сотрудник. Роли для команды раздаются в разделе «Доступ».
Ключ доступа сообщества: где взять и какие права отметить
Ключ доступа — это то, чем бот «представляется» ВКонтакте, чтобы отправлять сообщения от имени сообщества. Создаётся он в «Управление» → «Работа с API» → вкладка «Ключи доступа» → «Создать ключ».
ВКонтакте предложит отметить, к чему у ключа будет доступ. Для бота ЧБТ нужен один пункт — «Сообщения сообщества». Остальные права (управление сообществом, фотографии, документы, стена, статистика) боту не нужны; лишние галочки не сломают работу, но и не добавят ничего, кроме площади поражения, если ключ утечёт. Принцип простой: даём ровно то, что требуется.
Ключ показывается один раз — скопируйте его сразу. Если потеряли, создайте новый и удалите старый: сообщество может держать несколько ключей, и пока старый жив, любой, кому он попал, может писать от вашего имени.
Два практических совета. Во-первых, назовите ключ понятно — «ЧБТ бот», а не «ключ 1»: через полгода вы не вспомните, что это. Во-вторых, не вставляйте ключ в переписку, заметки и общие документы. Единственное место, где он должен оказаться, — поле «Токен» в разделе «Каналы» ЧБТ; там он хранится в зашифрованном виде и в интерфейсе больше не показывается.
Callback API: порядок действий между VK и ЧБТ
Callback API — это способ, которым ВКонтакте сообщает боту о новых сообщениях: при каждом событии VK отправляет запрос на адрес вашего сервера. Сервером выступает ЧБТ. Здесь важен порядок: адрес появится только после подключения канала, а строку подтверждения нужно знать до него. Поэтому окна ВКонтакте и ЧБТ удобно держать открытыми рядом.
- Во ВКонтакте: «Работа с API» → вкладка «Callback API». Выберите актуальную версию API. Ниже увидите «Строку, которую должен вернуть сервер» — скопируйте её. В поле «Секретный ключ» придумайте и впишите произвольную строку (латиница и цифры, 20–30 символов) — она нужна, чтобы ЧБТ отличал запросы от VK от чьих-то ещё. Адрес сервера пока не трогайте.
- В ЧБТ: откройте проект → «Каналы» → «Подключить ВКонтакте». Заполните три поля: «Токен» — ключ доступа из предыдущего раздела, «VK: строка подтверждения» — та самая строка, «VK: секретный ключ» — придуманный вами секрет. Нажмите «Подключить». Канал появится в списке, а рядом — адрес webhook вида
https://app.chbt.io/webhook/vk/<ID канала>. Скопируйте его. - Снова во ВКонтакте: вставьте адрес в поле «Адрес» на вкладке Callback API и нажмите «Подтвердить». VK отправит на адрес запрос-проверку, ЧБТ вернёт строку подтверждения, и сервер будет отмечен как подтверждённый.
- Типы событий: на соседней вкладке отметьте «Входящее сообщение» — без него бот не узнает, что ему написали. Если планируете кнопки, которые запускают ветки сценария (а вы планируете), отметьте также событие для callback-кнопок — «Действие с callback-кнопкой» (в API оно называется
message_event). Без него кнопки будут отрисовываться, но нажатия до сценария не дойдут.
Проверка: напишите сообществу с личной страницы. Если сценарий в ЧБТ включён, ответ придёт в течение секунды. Короткая версия этой инструкции без контекста — в справке по подключению ВКонтакте; там же — что проверять, если подтверждение не проходит.
Первый сценарий: шаблон, триггеры и особенности входа в VK
Сценарий в ЧБТ не привязан к каналу: тот же набор блоков работает во ВКонтакте, Telegram и MAX. Но вход у VK свой, и это надо учесть в триггерах.
С чего начать. Для сообщества, куда пишут «сколько стоит», возьмите шаблон «Автоответчик FAQ»: ключевые слова по ценам и графику, иначе — оператор. Для сообщества, где главное — заявки, — «Сбор заявок»: имя, телефон, благодарность. Шаблон открывается кнопкой «Использовать шаблон» и сразу оказывается в разделе «Сценарии», где его можно править в режиме «Шаги» (линейно, доступен на Бесплатном тарифе) или на «Холсте» (Базовый и выше).
Три триггера, которые должны быть в VK-сценарии.
- «Команда /start» — срабатывает на кнопку «Начать». ВКонтакте присылает служебное событие, ЧБТ превращает его в
/start. Это вход для тех, кто открыл диалог впервые. - «Ключевое слово» в режиме «содержит» — «цена», «стоимость», «адрес», «график». Люди во ВКонтакте пишут в сообщество как человеку, длинными фразами: «здравствуйте, подскажите пожалуйста сколько стоит стрижка». Режим «точно» здесь почти бесполезен.
- «Любое сообщение» — обязательный. У аудитории VK нет привычки к командам, никто не будет писать
/start. Если человек написал что-то, не попавшее в ключевые слова, сценарий должен всё равно ответить — меню кнопками или сразу передачей оператору. Пустой ответ в VK выглядит как игнор от сообщества.
Имя подтягивается само. При первом сообщении ЧБТ запрашивает у ВКонтакте имя и фамилию пользователя и записывает в карточку контакта — переменная {{name}} в сообщениях заполнится без вопроса «как вас зовут». Спрашивать имя блоком «Сбор данных» во ВКонтакте обычно не нужно; телефон — нужно, у VK его нет.
Если планируете выдавать материал по слову — «прайс», «чеклист», «промокод» — механика та же, что в Telegram и MAX: триггер «Ключевое слово» → «Сообщение» со ссылкой на материал → действие «Добавить тег». Готовый скелет под это — шаблон «Выдача лид-магнита».
Кнопки во ВКонтакте: 10 штук, по 2 в ряд, 40 символов
Кнопки в блоке «Сообщение» ЧБТ раскладывает под сообщением во ВКонтакте автоматически. Правила площадки, в которые это упирается:
- До 10 кнопок под одним сообщением. Если в блоке их больше, лишние не отобразятся — делите меню на два шага: «Услуги» → конкретные услуги.
- По 2 в ряд, то есть максимум 5 рядов. Восемь кнопок — четыре аккуратных ряда; семь — последняя останется одна в ряду, это нормально.
- Подпись до 40 символов. Более длинная будет обрезана. Пишите глаголами: «Записаться», «Узнать цену», «Позвать человека».
- Два типа кнопок. Кнопка-ссылка открывает URL — сайт, карту, прайс на диске. Кнопка-ветка запускает продолжение сценария (в ЧБТ это триггер «Нажатие кнопки» или следующий блок). Ветка требует включённого события callback-кнопок в настройках Callback API — см. выше.
Есть одна деталь поведения, о которой стоит знать. Когда человек нажимает кнопку-ветку, ВКонтакте показывает на ней индикатор ожидания, пока сервер не ответит. ЧБТ снимает его сразу при получении события, поэтому кнопка не «висит» — но если сценарий выключен или webhook сломан, пользователь увидит именно бесконечное ожидание на кнопке. Это удобный симптом при диагностике: «крутится и не отвечает» почти всегда означает проблему на стороне подключения, а не сценария.
И правило дизайна, не зависящее от платформы: последняя кнопка в любом меню — выход к человеку. «Оператор», «Задать свой вопрос», «Позвать администратора» — как назвать, неважно; важно, чтобы она была. Куда ведёт эта кнопка и как оператор подхватывает диалог, разобрано в статье бот или оператор: передача диалога.
Особенности VK, которые влияют на сценарий
Бот во ВКонтакте живёт по правилам ВКонтакте, и часть из них отличается от того, к чему привыкли владельцы Telegram-ботов.
- Пользователь может запретить сообщения от сообщества. Тогда бот ему не ответит, и в диалоге это будет выглядеть как молчание. Повлиять на это нельзя — только попросить разрешить сообщения на странице сообщества.
- Ответы администратора из интерфейса VK бот не видит. Если ваш сотрудник отвечает клиенту прямо во ВКонтакте, а не из «Диалогов» ЧБТ, сценарий об этом не узнает и может продолжить свою ветку поверх живого разговора. Договоритесь: пока бот включён, отвечаем из кабинета. Блок «Оператор» для этого и нужен — он останавливает бота в диалоге.
- Лимиты на отправку. ВКонтакте ограничивает число сообщений от сообщества в секунду. Для диалогов это не проблема; для рассылок по большой базе (раздел «Рассылки», Базовый тариф и выше) ЧБТ шлёт очередью с задержками — тысяча сообщений уйдёт за минуту-две, не мгновенно.
- Подписка на сообщество и переписка — разные вещи. Подписчик паблика не является контактом бота, пока не написал в сообщения. База для рассылок через бота — это те, кто писал, а не число подписчиков в шапке.
- Один ключ — одно сообщество. Ключ доступа выдаётся конкретному сообществу; для второго сообщества нужен второй ключ и второе подключение.
Что общее с другими каналами: карточки контактов из VK попадают в те же «Контакты», диалоги — в тот же инбокс, сделки — в ту же CRM. Если у вас уже есть Telegram-бот на ЧБТ, ВКонтакте подключается к нему как ещё один канал, а не как отдельный проект. Обзор канала и его возможностей — на странице чат-бота ВКонтакте.
Если бот молчит: восемь проверок
Список составлен по обращениям в поддержку — в таком порядке причины и встречаются.
- Сообщения сообщества выключены или выключены «Возможности ботов». Проверьте «Управление» → «Сообщения».
- Не отмечен тип события «Входящее сообщение» на вкладке «Типы событий» Callback API. Сервер подтверждён, а событий нет — это оно.
- Строка подтверждения не совпала. VK показал одну строку, в ЧБТ вставлена другая (или с пробелом). Сервер не подтверждается — сравните посимвольно.
- Секретный ключ не совпадает. В VK вписали один секрет, в ЧБТ — другой. ЧБТ молча отбрасывает такие запросы, VK считает их доставленными. Впишите одинаковый в оба места.
- У ключа доступа нет права на сообщения. События приходят, а ответ уходит с ошибкой. Создайте ключ заново с галочкой «Сообщения сообщества».
- Сценарий выключен или в нём нет триггера «Любое сообщение». Написали «привет» — ни одно ключевое слово не совпало, а поймать нечем. Добавьте catch-all.
- Исчерпан лимит Бесплатного тарифа — 30 диалогов в месяц на проект. После 30 собеседников за месяц с теми, кто уже писал в этом месяце, бот разговаривает как обычно, а новым вместо сценария отвечает служебной фразой о лимите, и их сообщения в «Диалоги» не попадают. Сколько диалогов набралось, показывает счётчик «N из 30» в карточке тарифа на странице «Обзор» бота и в разделе «Оплата». Лимит снимается на Базовом (650 ₽ за бота в месяц).
- Пользователь запретил сообщения от сообществ. Проверьте с другой страницы.
Порядок отладки: сначала «Проверить сценарий» в редакторе — он покажет, что логика работает без ВКонтакте; потом сообщение в сообщество с личной страницы. Если первое работает, а второе нет — проблема в подключении, пункты 1–5.
Что подключать следующим
Первый сценарий — это автоответы и заявки. Когда он проработал неделю и вы увидели в «Диалогах», о чём люди спрашивают на самом деле, есть три логичных шага.
- Теги и сегменты. Действие «Добавить тег» на ветках («спросил-цену», «записался», «ждёт-оператора») — и через месяц в «Контактах» видно, чего хотят подписчики. По тегам запускаются рассылки — например, «свободное окно завтра в 15:00» тем, кто интересовался записью.
- ИИ-агент на свободные вопросы. На Базовом тарифе в сценарий добавляется блок «ИИ-агент»: вы описываете компанию, услуги и цены обычным текстом в разделе «ИИ-агенты», и агент отвечает на вопросы, не попавшие в ключевые слова, а при неуверенности зовёт оператора. Один ответ агента — один ИИ-кредит, в Базовый входит 150 в месяц.
- Второй канал. Если у вас есть аудитория в Telegram или MAX, подключите их в тот же проект: сценарий, контакты и инбокс станут общими, а различия в текстах — если понадобятся — разводятся блоком «Условие» по каналу.
На Бесплатном тарифе всё описанное в статье — подключение ВКонтакте, шаблон, кнопки, оператор в «Диалогах» — доступно без карты; ограничение одно — 30 диалогов в месяц. Этого достаточно, чтобы понять, снимает ли бот нагрузку с администратора сообщества. Создать бота для сообщества ВКонтакте →
Чат-бот ВКонтакте для сообществаСправка: подключение ВКонтактеШаблон «Сбор заявок»Шаблон «Автоответчик FAQ»Передача диалога оператору