Главная · Справка · Бот сообщества ВКонтакте молчит: чеклист
Бот сообщества ВКонтакте молчит: чеклист
У бота ВКонтакте две стороны, которые ломаются независимо: настройки сообщества (события не доходят до ЧБТ) и сценарий с тарифом (события доходят, ответа нет). Первый шаг — понять, на какой стороне обрыв, затем пройти чеклист этой стороны. Всё вместе — две минуты.
Шаг 0. Где обрыв: тест за 30 секунд
- С личной страницы (не от имени сообщества) откройте сообщения сообщества и отправьте любой текст, например «тест».
- В кабинете ЧБТ откройте раздел «Диалоги».
- Сообщение появилось, ответа нет → события доходят, подключение работает. Смотрите чеклист «Сторона ЧБТ» ниже.
- Сообщения нет → ВКонтакте не отправляет события или ЧБТ их отбрасывает. Смотрите чеклист «Сторона ВКонтакте».
Дополнительно нажмите «Проверить сценарий» в редакторе: тест-чат работает без ВКонтакте. Если там бот отвечает, а в сообществе нет, — сценарий исправен, дело в подключении.
Сторона ВКонтакте: события не доходят
Все пункты — в «Управлении» сообщества и в «Каналах» ЧБТ, нужны права администратора сообщества.
- «Сообщения» → «Сообщения сообщества: Включены». Выключены — у людей нет кнопки «Написать», и ВКонтакте не отправляет ничего.
- Статус канала в «Каналах» ЧБТ. «Работает» ставится, только когда ВКонтакте подтвердил сервер ЧБТ. «Ошибка» — под статусом причина: что она значит и как исправить, — в таблице ошибок инструкции по подключению.
- Сервер «ЧБТ» в «Работа с API» → «Callback API». При подключении ЧБТ сам заводит его с адресом
https://app.chbt.io/webhook/vk/номер_канала, секретом, версией API и нужными событиями. Статус сервера — «подтверждён». Если сервер удалили или поменяли в нём адрес, секрет, версию или типы событий, нажмите «Переустановить webhook» в строке канала: ЧБТ настроит всё заново. - Канал подключён к тому сообществу. В строке канала в «Каналах» — название сообщества, в которое вы пишете. Если сообществ несколько, легко подключить не то.
Сторона ЧБТ: событие пришло, ответа нет
- Права ключа доступа. У ключа канала есть право «Сообщения сообщества». Без него событие доходит, а отправка ответа отклоняется: в «Диалогах» у ответа бота пометка «не доставлено». Так бывает у каналов, подключённых по ключу без этого права. Создайте ключ с правами «Сообщения сообщества» и «Управление сообществом» и вставьте его через «Изменить ключ» в строке канала — или подключите сообщество заново кнопкой «Подключить через ВКонтакте».
- Сценарий включён и есть вход для VK. «Сценарии» → на карточке сценария плашка «Включён», а не «Черновик»; включается он переключателем на карточке. Во ВКонтакте клиенты не набирают
/start: триггер «Команда (/start)» срабатывает на кнопку «Начать», а она появляется, когда в «Настройках для бота» включены «Возможности ботов» и отмечено «Добавить кнопку «Начать»». Текст «здравствуйте, сколько стоит» ловят только «Ключевые слова» или «Любое сообщение» — без них бот отвечает на кнопку и молчит на слова. - Лимит Бесплатного тарифа. 30 диалогов в месяц на бота по всем каналам вместе. Признак — новым собеседникам бот отвечает одной фразой «Сейчас мы не можем ответить в этом чате» вместо сценария; с теми, кто уже писал в этом месяце, разговор продолжается. Тариф — в подзаголовке «Обзора», снимается в «Оплате»: Базовый — 650 ₽/мес.
- Диалог у оператора. Если в сценарии сработал блок «Оператор», бот в этом диалоге молчит намеренно, пока в «Диалогах» не нажать «Вернуть боту». Так бывает и с собственным тестовым диалогом владельца: после проверки блока «Оператор» диалог остаётся у оператора.
Ещё один случай вне чеклиста — пользователь запретил сообщения от сообщества. Бот ответить не может: в «Диалогах» у ответа бота появится пометка «не доставлено», а при наведении на неё — текст ошибки от ВКонтакте. Проверяйте с другой страницы.
Симптом → куда смотреть
| Симптом | Вероятная причина | Пункт |
|---|---|---|
| Статус канала «Ошибка» | Ключ без прав, ключ отозван или ВКонтакте не подтвердил сервер | 2 |
| В «Диалогах» пусто, канал «Работает» | Выключены сообщения сообщества, сервер «ЧБТ» удалён или изменён, подключено не то сообщество | 1, 3, 4 |
| Сообщение в «Диалогах» есть, ответа нет | Ключ без права на сообщения, сценарий выключен, лимит | 5, 6, 7 |
| Отвечает на «Начать», молчит на текст | Нет триггера «Любое сообщение» / «Ключевые слова» | 6 |
| Кнопка «крутится», ответа нет | У сервера «ЧБТ» поменяли типы событий или сценарий выключен | 3, 6 |
| Новые собеседники получают одну фразу про лимит | Исчерпаны 30 диалогов Free | 7 |
| Молчит только у одного человека | Диалог у оператора или запрет сообщений от сообщества | 8 |
С какого аккаунта тестировать
Пишите сообществу с личной страницы — своей или коллеги. Ответы администратора из интерфейса ВКонтакте событий боту не создают, и сценарий их не видит. Для чистого теста нужна страница, которая сообществу ещё не писала: так проверяются и кнопка «Начать», и первое сообщение.
Как настраивалось подключение по шагам — в инструкции по подключению ВКонтакте; полный путь от ключа доступа до первого сценария с объяснением каждой настройки — в статье бот ВКонтакте для сообщества. Что бот умеет в этом канале — на странице чат-бота ВКонтакте. Аналогичные чеклисты: Telegram и MAX. Если сообщество ещё без бота — подключите его бесплатно: ВКонтакте входит в Бесплатный тариф.
Частые вопросы
Поменял ключ доступа — что обновить в ЧБТ?
В «Каналах» в строке канала нажмите «Изменить ключ» и вставьте новый. Канал, его адрес и переписка останутся прежними, в Callback API ничего менять не нужно. Если новый ключ не подойдёт, ЧБТ вернёт старый.
Бот отвечает на кнопку «Начать», но не на текст. Это поломка?
Нет. Кнопка «Начать» запускает триггер «Команда (/start)», а для обычного текста нужен триггер «Любое сообщение» или «Ключевые слова». Добавьте его в сценарий — во ВКонтакте люди пишут словами, а не командами.
В ВКонтакте написано «доставлено», а в ЧБТ ничего нет. Почему?
Так выглядит чужой секрет: у сервера «ЧБТ» в Callback API кто-то поменял секретный ключ, и ЧБТ отвечает ВКонтакте «ok», но запрос отбрасывает. Нажмите «Переустановить webhook» в строке канала — ЧБТ заново настроит сервер со своим секретом.