Главная · Справка · Подключение MAX

Подключение MAX

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

Шаг 1. Возьмите токен бота в MAX для бизнеса

Откройте кабинет MAX для бизнеса — business.max.ru — и создайте бота или выберите уже существующего.
Скопируйте токен бота целиком.

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

Шаг 2. Вставьте токен в «Каналах»

В кабинете app.chbt.io откройте бота → раздел «Каналы» → в блоке «Подключить новый канал» у карточки MAX нажмите «Подключить».
При желании заполните «Название канала» для себя, вставьте токен в поле «Токен» и нажмите «Подключить MAX».
ЧБТ запросит у MAX данные бота по этому токену (метод /me), затем оформит подписку (POST /subscriptions): передаст MAX адрес вида https://app.chbt.io/webhook/max/<номер канала>, куда платформа будет присылать события бота. Поля для адреса в кабинете нет.

После этого кабинет откроет «Обзор» бота: в карточке «Каналы» появится строка MAX со статусом. Если название не заполняли, а подключение прошло, строку подпишут username бота из MAX, а если его нет — именем бота. «Работает» — MAX принял токен и подписку, можно переходить к проверке. «Ошибка» — под статусом будет причина:

«Неверный токен MAX или API недоступен». MAX не вернул данные бота по этому токену: токен скопирован не полностью, уже заменён в кабинете MAX или MAX в этот момент не ответил. Скопируйте токен заново и подключите MAX ещё раз, а строку с ошибкой удалите в «Каналах»: кнопка «⋯» → «Удалить». Переписки в ней нет — бот через неё не работал.
Другой текст. Токен MAX принял, а подписка не удалась: под статусом ответ MAX или текст сетевой ошибки. Откройте «Каналы» и нажмите «Переустановить webhook» в строке канала.

Подключать каналы могут владелец бота и админы, у роли «Оператор» блока подключения нет.

Шаг 3. Проверьте с телефона

Откройте «Сценарии»: на карточке нужного сценария должна стоять плашка «Включён», а не «Черновик». Включается сценарий переключателем на его карточке или в списке сценариев на «Обзоре».
Откройте сценарий в редакторе и проверьте триггеры: «Команда (/start)» — для кнопки «Начать», «Любое сообщение» или «Ключевые слова» — для обычного текста.
Откройте бота в MAX с телефона и нажмите «Начать». MAX присылает это событием старта бота, а ЧБТ обрабатывает его как команду /start. Затем отправьте любой текст.
В кабинете откройте «Диалоги»: там появился диалог с каналом MAX, в нём ваши сообщения и ответы бота.

Ваши сообщения в «Диалогах» есть, а ответа бота там нет — подключение в порядке, дело в сценарии. Ответ в «Диалогах» есть, но с пометкой «не доставлено» — отправка в MAX не удалась: наведите на пометку, в подсказке будет текст ошибки. Бот ответил фразой «Лимит диалогов на бесплатном тарифе исчерпан», а вашего сообщения в «Диалогах» нет — подключение тоже в порядке: на Бесплатном тарифе с 1-го числа боту уже написали 30 разных контактов, и новым бот отвечает только этой фразой. Ваш аккаунт MAX для бота — такой же контакт, как клиент, и тоже входит в эти 30. Нет ни сообщения, ни ответа — вернитесь к статусу канала. Отделить сценарий от подключения помогает кнопка «Проверить сценарий» в редакторе: тест-чат работает без MAX и в лимит не входит.

Статус канала, «Переустановить webhook» и новый токен

Отдельной фоновой проверки канала в ЧБТ нет: статус MAX-канала меняется только по событиям. «Работает» ставится, когда MAX принял токен и подписку при подключении или после «Переустановить webhook», и когда сообщение от имени бота ушло успешно. «Ошибка» — когда подключение или переустановка не удались и когда MAX отклонил токен (ответ 401) при отправке ответа бота, сообщения оператора или рассылки. Входящие сообщения статус MAX-канала не меняют, так что «Работает» — итог последнего такого события, а не проверка «прямо сейчас».

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

Если MAX отклонил токен при отправке, строка канала переходит в «Ошибку» с текстом «токен бота отклонён (401 Unauthorized)», а владельцу и админам бота приходит письмо «Бот … требует внимания»: не чаще раза в сутки и если в «Уведомлениях» не выключены «Email-уведомления» или пункт «Статус ботов». «Переустановить webhook» здесь не поможет: кнопка работает со старым токеном, а поля для нового в канале нет. Подключите MAX заново с актуальным токеном и дождитесь статуса «Работает» у новой строки. Старую строку можно удалить (кнопка «⋯» → «Удалить»), но вместе с ней из «Диалогов» пропадёт вся переписка, которая шла через этот канал. Контакты с тегами и полями останутся. Если в переписке есть что-то важное, сохраните это до удаления.

Полный чеклист причин, почему бот в MAX молчит, — в справке «Бот MAX молчит».

Особенности канала, о которых стоит знать сразу

Бот в MAX отправляет текст и кнопки двух видов: переход в ветку сценария и ссылку. Кнопки выводятся под сообщением в один ряд. «Быстрые ответы» из блока «Сообщение» в MAX не показываются. Фото, видео и файлы ЧБТ в MAX не отправляет — материалы давайте ссылкой.
Диалог начинает клиент: контакт MAX появляется в ЧБТ, когда человек нажимает «Начать» или пишет боту.
Ссылка с меткой: если бота открыли по ссылке с параметром, MAX передаёт его в событии старта, и его ловит триггер «Deeplink». Под метку заводят отдельный сценарий и в нём действием «Добавить тег» отмечают источник («сайт», «листовка»). Формат такой ссылки уточняйте в документации MAX для бизнеса: «QR-кампании» ЧБТ пока строят ссылки с меткой только для Telegram.
Один сценарий работает и в MAX, и в Telegram, и во ВКонтакте — если бот уже есть в другом мессенджере, ничего переделывать не нужно: один сценарий на два мессенджера. На Бесплатном тарифе человек, написавший боту и в Telegram, и в MAX, — это два контакта из 30.

Возможности канала — на странице бота для MAX; путь с нуля до первого сценария — в статье как создать бота в MAX. MAX входит в Бесплатный тариф — зарегистрируйтесь и подключите бота.

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

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

Бот отвечает на «Начать», но молчит на текст. Почему?
Кнопка «Начать» запускает триггер «Команда (/start)», а для обычного текста нужен триггер «Любое сообщение» или «Ключевые слова». Добавьте его в сценарий.

Сменил токен бота в MAX — что сделать в ЧБТ?
Подключить MAX в «Каналах» заново с новым токеном: поля для токена в подключённом канале нет, а «Переустановить webhook» работает со старым. Старую строку канала удаляйте, помня, что вместе с ней из «Диалогов» пропадёт её переписка; контакты останутся.

Можно ли подключить MAX к боту, который уже работает в Telegram?
Да, в том же боте ЧБТ: «Каналы» → карточка MAX → «Подключить». Сценарий общий, переписка из обоих мессенджеров — в одних «Диалогах». На Бесплатном тарифе человек, написавший и в Telegram, и в MAX, считается двумя контактами из 30.

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

Бот для MAX Бот MAX молчит Как создать бота в MAX Подключение Telegram