Откройте настройки бота — там есть карточка «Webhook». Зелёное «Установлен» означает, что адрес обработчика прописан на стороне МАКС и входящие до нас доходят. Красное «Не установлен» — связи нет, почти всегда дело в ключе. Точка рядом с ботом в общем списке показывает другое: включён бот или выключен.
Хотите убрать бота, который вам мешает? Скорее всего, речь про служебного бота с кодами подтверждения — его создал сам мессенджер, к нашему сервису он отношения не имеет. Отключить или скрыть его можно в настройках приложения. Эта статья — для тех, кто делает своего бота.
Проверка 1. Есть ли связь с мессенджером
Это самая быстрая проверка, и с неё стоит начинать всегда: она отвечает на вопрос «мессенджер вообще знает, куда слать сообщения?».
Откройте настройки бота — там есть карточка «Webhook». Зелёное «Установлен» означает, что адрес обработчика прописан на стороне МАКС и входящие до нас доходят. Красное «Не установлен» — связи нет, почти всегда дело в ключе. Точка рядом с ботом в общем списке показывает другое: включён бот или выключен.
Что делать, если индикатор не зелёный:
- Проверьте ключ на пробелы. Самая частая причина — пробел, случайно прихваченный при копировании в начале или в конце строки.
- Убедитесь, что ключ актуальный. Если кто-то в кабинете МАКС перевыпустил ключ, старый перестал работать в ту же секунду.
- Посмотрите статус бота в кабинете МАКС. Иногда бота случайно ставят на паузу — тогда со стороны площадки он «остановлен».
- Проверьте тумблер паузы у нас. В настройках бота есть переключатель «Бот приостановлен» — он должен быть выключен.
В настройках бота есть две кнопки, которые закрывают почти все вопросы этого уровня: «Проверить статус» — сервис заново спрашивает у МАКС, жив ли ключ, и «Переустановить webhook» — заново прописывает адрес обработчика. Если после них точка позеленела, проблема была в подключении и она решена.
Проверка 2. Напишите боту сами
Индикатор говорит о связи, но не о том, что бот отвечает по делу. Самая честная проверка — пройти путь клиента:
- Откройте МАКС и найдите своего бота по имени.
- Нажмите «Написать» и отправьте любое сообщение.
- Посмотрите, ответил ли он и что именно ответил.
Если ответил — работает всё: приём сообщений, сценарий, отправка. Дальше стоит пройти меню целиком: нажать каждую кнопку, проверить ссылки, убедиться, что передача диалога живому сотруднику действительно срабатывает.
Заодно откройте раздел «Диалоги» в кабинете. Ваше сообщение должно появиться там в течение секунды. Это разделяет две разные поломки:
- Сообщение в кабинете есть, ответа нет — приём работает, проблема в сценарии. Переходите к третьей проверке.
- Сообщения в кабинете нет — до нас оно не дошло. Возвращайтесь к первой проверке: ключ, статус бота в кабинете МАКС, переустановка обработчика.
Тестировать лучше со второго аккаунта МАКС, заведённого на другой номер. Так вы увидите бота ровно тем, кем его видит клиент, — включая приветствие для того, кто пишет впервые.
Проверка 3. Работает ли сценарий
Бывает, что бот на связи, входящие видит, но молчит. Причина почти всегда одна из четырёх.
Сценарий не запущен. Собран, сохранён, но переключатель выключен. Самая обидная и самая частая причина.
Не совпало условие запуска. Сценарий ждёт конкретного слова или нажатия кнопки, а человек написал «здравствуйте». На старте полезно иметь один сценарий, который срабатывает на любое входящее сообщение, — тогда клиент не упрётся в тишину, что бы он ни написал.
Диалог «застрял». Бот ждёт ответа на предыдущий шаг — например, номер телефона, — а вы пишете что-то другое. Помогает перезапуск диалога: тогда сценарий начнётся с начала. Такие тупики — типичная беда первых сборок, про них подробно в разборе структуры сценария и тупиков в диалоге.
Сценарий привязан к другому боту. Один сценарий можно применить сразу к нескольким ботам, и наоборот — легко собрать его, но забыть отметить в списке нужного бота.
Если ни одна из четырёх причин не подошла, полезно пробежать 10 частых ошибок при сборке ботов — почти всё, что ломает первый запуск, там есть.
Как проверять до запуска, не трогая клиентов
Тестировать на живых людях не обязательно. В конструкторе есть режим, где сценарий прогоняется как в бою — с реальными условиями, переменными и ветвлениями, — но сообщения никуда не уходят. Видно, какие блоки сработали, в каком порядке и что бот собирался отправить.
Такой прогон ловит большую часть ошибок до того, как их увидит клиент: пустую ветку, кнопку, которая никуда не ведёт, условие, которое никогда не выполняется. Диалоги из прогона не попадают в общий раздел с перепиской и не расходуют лимит тарифа.
Отдельно проверьте передачу диалога человеку. Это тот участок, который ломается тише всего: бот вроде отвечает, а кнопка «Связаться с оператором» ведёт в никуда. Как это должно быть устроено — в статье о том, как настроить передачу диалога оператору.
Бот работал и вдруг перестал
Если бот работал неделями, а сегодня замолчал, вариантов немного.
Ключ перевыпустили. Кто-то в кабинете МАКС нажал «Сгенерировать новый ключ» — старый умирает мгновенно. Сценарии, теги и история переписки при этом никуда не деваются: достаточно скопировать новый ключ и вставить его в настройках бота.
Тот же ключ использовали в другом сервисе. МАКС отправляет входящие только по одному адресу — последнему, который прописали. Если ключ вставили в другой конструктор, сообщения ушли туда.
Закончился месячный лимит. На бесплатном тарифе «Старт» доступно 50 диалогов в месяц. Когда лимит исчерпан, новым людям бот отвечать перестаёт, а те, с кем разговор уже начался, продолжают общаться как ни в чём не бывало. Отсюда и ощущение «работает через раз». Счётчик виден в кабинете и обнуляется первого числа.
Бота остановили в кабинете МАКС. Проверьте статус на стороне площадки — бот должен быть активен.
Короткий чек-лист
Если нужно быстро, без чтения всего текста:
- Зелёная точка рядом с ботом в кабинете. Нет — ключ или статус бота в МАКС.
- Написали боту сами — сообщение появилось в разделе «Диалоги». Нет — проблема в подключении.
- Бот ответил. Нет — сценарий выключен, не совпало условие или диалог застрял.
- Прошли всё меню кнопками, проверили ссылки и передачу оператору.
- Прогнали сценарий в тестовом режиме перед тем, как звать клиентов.
Если вы ещё не дошли до этого этапа и бот только предстоит подключить — начните с инструкции о том, как создать бота в МАКС по шагам. А что канал умеет и кому он окупается — на странице про чат-ботов в МАКС.
Частые вопросы
Как понять, что бот в МАКС подключён?
Откройте настройки бота — там есть карточка «Webhook». Зелёное «Установлен» означает, что адрес обработчика прописан на стороне МАКС и входящие до нас доходят. Красное «Не установлен» — связи нет, почти всегда дело в ключе. Точка рядом с ботом в общем списке показывает другое: включён бот или выключен.
Бот на связи, но не отвечает — почему?
Скорее всего, сценарий выключен или не совпало условие запуска: бот ждёт конкретного слова, а человек написал иначе. Реже диалог «застрял» на предыдущем шаге — тогда помогает перезапуск диалога.
Можно ли проверить бота, не показывая его клиентам?
Да. В конструкторе есть тестовый прогон: сценарий выполняется по-настоящему, но сообщения никуда не уходят. Такой диалог не попадает в общую переписку и не расходует лимит тарифа.
Бот работал и перестал. Что случилось?
Чаще всего перевыпустили ключ доступа в кабинете МАКС — старый перестаёт работать сразу же. Второй по частоте вариант — исчерпан месячный лимит диалогов на бесплатном тарифе: новым людям бот не отвечает, старые разговоры продолжаются.
Сообщение клиента не дошло до кабинета — что проверить?
Значит, мессенджер не доставил входящее до сервиса. Проверьте, активен ли бот в кабинете МАКС, скопирован ли ключ целиком без пробелов, и нажмите «Переустановить webhook» в настройках бота — это заново пропишет адрес обработчика.
Как протестировать бота как обычный клиент?
Заведите второй аккаунт МАКС на другой номер и пишите боту с него. Так вы увидите ровно то, что видит новый человек, включая первое приветствие, — и не будете «пугать» реальных клиентов черновиками.