Если бот уже создан и прошёл модерацию, переходите сразу к разделу «Подключите токен в VKUCHE». Для работы с группой всё равно понадобятся отдельное разрешение в MAX Business и права администратора в самой группе.
Что понадобится
- Подтверждённый профиль в MAX Business: самозанятый, ИП или организация.
- MAX-бот, который прошёл модерацию.
- Токен доступа этого бота.
- Доступ к разделу «Каналы» в VKUCHE.
- Права, позволяющие добавить бота и назначить его администратором нужной группы.
Создайте бота в MAX Business
- Откройте MAX Business и войдите под подтверждённым профилем.
- Перейдите в раздел «Чат-боты» и нажмите «Перейти».
- Создайте бота, заполните сведения о нём и отправьте на модерацию.
- Дождитесь одобрения. После этого токен появится в расширенных настройках бота.
Если раздел создания ботов недоступен, сначала проверьте статус профиля MAX Business. Рабочего бота можно создать только для подтверждённого самозанятого, ИП или организации.
Читайте такжеОфициальная инструкция MAX по созданию чат-ботаПодключите токен в VKUCHE
- В MAX Business откройте «Чат-боты» → «Перейти» → «Расширенные настройки».
- Скопируйте токен доступа.
- Войдите в кабинет VKUCHE и откройте раздел «Каналы».
- Нажмите «Подключить канал» и выберите «MAX: бот, группы и каналы».
- Укажите понятное название подключения, вставьте токен в поле «Токен MAX-бота» и сохраните.
Секретный ключ вводить не нужно. После сохранения VKUCHE сам настраивает приём сообщений.
Личный диалог можно проверить сразу: отправьте боту сообщение с другого аккаунта MAX. Новый чат появится в разделе «Чаты».
Разрешите добавлять бота в группы
По умолчанию MAX не разрешает добавлять нового бота в групповые чаты. Это настраивается отдельно:
- Вернитесь в MAX Business.
- Откройте «Чат-боты» → «Перейти» → «Расширенные настройки».
- Нажмите «Настроить».
- Разрешите добавление бота в групповые чаты и сохраните настройку.
Если пропустить этот шаг, найти и добавить бота в нужную группу не получится.
Добавьте бота в группу и выдайте права
- Откройте нужную группу в MAX.
- Добавьте созданного бота в число участников.
- Откройте настройки группы и перейдите к списку администраторов.
- Назначьте бота администратором.
- Включите право «Читать все сообщения» и сохраните изменения.
Отправьте тестовое сообщение в самой группе
Личное сообщение боту проверяет только личный диалог. Чтобы проверить групповое подключение, нужен отдельный тест:
- Отправьте обычное сообщение от участника в той группе, куда добавлен бот.
- Откройте в VKUCHE раздел «Чаты».
- Найдите новый чат с названием группы.
Что проверить, если сообщения не приходят
| Что происходит | Что проверить |
|---|---|
| Бота нельзя добавить в группу | В расширенных настройках MAX Business должно быть разрешено добавление в групповые чаты. |
| Бот есть в группе, но сообщений нет | Назначьте бота администратором и включите право «Читать все сообщения». |
| Личные сообщения приходят, а групповые нет | Отправьте тест именно в группе и ещё раз проверьте права бота. |
| Группа не отображается в VKUCHE | Она появится после первого сообщения, полученного из этой группы. |
| Настройки верны, но тест не проходит | Удалите бота из группы, добавьте заново и повторно выдайте права администратора. |
После повторной настройки отправьте новое сообщение от участника группы. Старое сообщение, написанное до выдачи прав, не подходит для проверки.
Как работает подключение после настройки
Для личных диалогов, групп и каналов не нужно создавать отдельного бота. В VKUCHE они относятся к одному подключению MAX, а новые обращения появляются в общем разделе «Чаты».
Если вы добавляете того же бота ещё в одну группу, повторите для неё настройку администратора и права «Читать все сообщения». Новый групповой чат появится после первого сообщения в этой группе.
Частые вопросы
Нужен ли секретный ключ MAX?
Нет. Для подключения в VKUCHE нужен только токен MAX-бота, который прошёл модерацию.
Почему бот отвечает в личном чате, но не видит группу?
Личные и групповые сообщения настраиваются отдельно. Проверьте разрешение на добавление в группы, назначение бота администратором и право «Читать все сообщения».
Когда группа появится в VKUCHE?
После первого сообщения, отправленного участником в самой группе. Личное сообщение боту не создаёт групповой чат.
Можно ли использовать одного бота в нескольких группах?
Да. Добавьте его в каждую нужную группу, выдайте права администратора и отправьте тестовое сообщение в каждой группе.
Что делать, если все права включены, но сообщений всё равно нет?
Удалите бота из группы, добавьте его заново, снова включите право «Читать все сообщения» и отправьте новое тестовое сообщение.