Подключить бота MAX

Для каких задач подходит

Подключённого бота можно использовать для:

• получения заявок
• общения с клиентами
• интерактивного меню
• сценариев
• мини-приложений
• других инструментов автоматизации.

Что понадобится

Перед началом подготовьте:

• аккаунт MAX;
• созданный бизнес-профиль;
• бизнес-бот MAX, прошедший модерацию;
• токен этого бота.

Если бизнес-профиль или бот ещё не созданы, это можно сделать на официальной платформе MAX для бизнеса: Перейти в MAX для бизнеса

На следующем шаге разберём, как создать бота и где найти его токен.

Подключить бота можно двумя способами:

• через раздел «Проекты»
• во время «Первого запуска».

Оба варианта рассмотрим отдельно.

Способ 1. Подключить бота MAX через «Первый запуск»

Этот способ подойдёт, если вы только зарегистрировались и подключаете своего первого бизнес-бота.

После завершения регистрации откроется раздел «Первый запуск». Он последовательно проведёт вас от выбора задачи до подключения и проверки бота.

1. Выберите задачу «Получать заявки»

На первом шаге появится вопрос «Что запустим в первую очередь?».

Выберите карточку «Получать заявки».

На этом примере будет подготовлен простой рабочий сценарий, с помощью которого после подключения можно сразу проверить работу бота.

На этом же экране доступны и другие задачи, но дальнейшие шаги для них могут отличаться.

2. Выберите MAX

1. На следующем шаге откроется экран «Где будет работать бот?».
2. Выберите карточку MAX.
3. После этого откроется этап подключения бизнес-бота.

3. Вставьте токен бота

На экране «Подключите бота» поле «Токен бизнес-бота MAX».

Вставьте токен бизнес-бота, полученный после создания и модерации бота в MAX.

Если токена у вас ещё нет, сначала перейдите к разделу «Как получить токен бота MAX», получите его и затем вернитесь к этому шагу.

Перед продолжением проверьте:

• токен скопирован полностью;
• перед токеном и после него нет лишних пробелов;
• токен относится именно к тому боту, которого вы хотите подключить.

Вставьте токен бизнес-бота MAX

Важно: токен является секретным ключом бота. Не публикуйте его, не показывайте на скриншотах и не передавайте посторонним.

4. Подключите бота

После ввода токена нажмите «Подключить бота».

Система проверит токен и текущее состояние подключения, а затем подготовит выбранный маршрут.

Дождитесь окончания проверки и не закрывайте страницу.

5. Начните живую проверку

После успешного подключения откроется последний этап «Проверка».

На экране появится сообщение «MAX подключён». Это означает, что токен принят и бот связан с проектом.

Теперь нужно убедиться, что сообщения действительно проходят из MAX в кабинет.

Нажмите «Начать живую проверку».

6. Откройте бота MAX

После запуска проверки появится специальный код и кнопки:

• «Скопировать код»;
• «Открыть бота».

Сначала нажмите «Скопировать код».

После этого нажмите «Открыть бота», чтобы перейти к подключённому боту в мессенджере MAX.

7. Запустите бота

Откроется страница вашего бота в MAX-мессенджере.

Если сначала появилась карточка бота, нажмите «Открыть в браузере».

После открытия чата нажмите «Начать», если раньше ещё не запускали этого бота.

Затем вставьте скопированный на предыдущем шаге код и отправьте его боту отдельным сообщением.

Система автоматически проверит весь путь сообщения: сообщение поступило из MAX, было принято и обработано, а бот смог отправить ответ обратно.

Возвращаться в кабинет и дополнительно подтверждать получение сообщения вручную не нужно — результат проверки обновится автоматически.

Важно: проверочный код используется только для проверки связи с вашим подключённым ботом.

8. Подготовьте политику проекта

После успешной проверки сообщения вернитесь в кабинет.

На экране появится сообщение «Тестовое сообщение получено». Это означает, что связь с ботом уже работает.

После проверки сообщения подготовьте политику проекта.

Откроется раздел «Политика проекта».

Укажите:

• название документа;
• версию или дату;
• название ссылки, которое будет отображаться в формах;
• текст вашей политики обработки персональных данных.

Политика должна соответствовать тем данным, которые вы действительно собираете и обрабатываете.

После заполнения нажмите «Сохранить и вернуться».

Заполните данные политики и сохраните документ

Важно: система хранит и отображает указанный вами текст, но не заменяет юридическую проверку документа. Используйте собственную актуальную политику обработки персональных данных.

9. Проверьте готовый сценарий

После сохранения политики вы вернётесь к проверке первого запуска.

На этом этапе уже подтверждены:

• проект подготовлен;
• бот подключён;
• тестовое сообщение получено.

Теперь нужно включить подготовленный сценарий заявки.

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

Если сценарий подходит, отметьте:

«Я проверил сценарий и подтверждаю ответственность за его содержание, политику и цели обработки данных».

После этого нажмите «Включить и перейти к тесту».

Проверьте готовый сценарий и включите его для тестирования

Если хотите изменить вопросы: нажмите «Просмотреть вопросы», внесите необходимые изменения в сценарий, сохраните их и вернитесь к проверке.

10. Оставьте тестовую заявку

После включения сценария останется проверить весь путь так, как его будет проходить обычный клиент.

Нажмите «Открыть бота и оставить заявку».

После нажатия кнопки «Открыть бота и оставить заявку» откроется мессенджер MAX с подключённым ботом.

Пройдите подготовленный сценарий полностью, как это будет делать обычный клиент: последовательно ответьте на вопросы бота и укажите тестовые контактные данные.

После завершения сценария бот подтвердит, что заявка принята. Затем вернитесь в личный кабинет и проверьте, что тестовая заявка появилась в разделе «Заявки».

11. Проверьте, что заявка поступила

Вернитесь в кабинет.

После получения заявки экран обновится автоматически и появится сообщение «Тестовая заявка получена».

В блоке «Прогресс запуска» теперь должны быть выполнены все пять пунктов:

• проект подготовлен;
• бот подключён;
• сообщение получено;
• сценарий включён;
• заявка получена.

Нажмите «Открыть заявки».

После успешного прохождения сценария первый запуск будет завершён

12. Откройте полученную заявку

Откроется раздел «Клиенты и заявки → Заявки».

В списке должна появиться только что созданная тестовая заявка.

Здесь можно увидеть:

• имя клиента;
• форму, через которую поступила заявка;
• статус;
• источник;
• ответственного;
• дату создания.

Откройте заявку и убедитесь, что переданные во время теста данные сохранились правильно.

Проверьте, что тестовая заявка появилась в списке и данные передались правильно

Способ 2. Подключить бота MAX через раздел «Проекты»

Этот способ подойдёт, если у вас уже есть личный кабинет и вы хотите подключить ещё одного бота MAX.

1. Откройте раздел «Проекты»

В левом меню выберите «Проекты».

На странице отображаются уже подключённые боты, их мессенджер, статус и последняя активность.

2. Нажмите «Создать проект»

В правой верхней части страницы нажмите «Создать проект».

Откроется окно «Подключить бота».

3. Заполните данные проекта

В открывшемся окне укажите:

Название — введите понятное название проекта, по которому вы сможете отличить его от других подключений.

Мессенджер — выберите MAX Messenger.

Токен доступа — вставьте токен нужного бизнес-бота MAX.

Если токена ещё нет, воспользуйтесь разделом «Как получить токен бота MAX».

После заполнения нажмите «Подключить».

Важно: токен вставляйте полностью, без пробелов в начале и конце.

4. Заполните политику проекта

После успешного подключения откроется страница созданного проекта.

В верхней части появится блок «Завершите подготовку проекта для MAX» и сообщение о том, что необходимо заполнить политику обработки данных.

Нажмите «Заполнить политику».

Откроется уже знакомый раздел «Политика проекта».

Укажите:

• название документа;
• версию или дату;
• название ссылки в формах;
• текст своей политики.

После заполнения нажмите «Сохранить и вернуться».

5. Запустите живую проверку

После сохранения политики вы вернётесь на страницу проекта.

В блоке «Проверка приёма и доставки» отображается состояние подключения. После создания проекта токен, статус проекта и защищённое подключение уже должны быть подтверждены. После заполнения политики останется провести живую проверку входящего сообщения и ответа бота.

Нажмите «Запустить живую проверку».

Дальше сама проверка выполняется так же, как при первом запуске:

1. нажмите «Скопировать код»;
2. нажмите «Открыть бота»;
3. откройте подключённого бота в MAX;
4. нажмите «Начать», если диалог запускается впервые;
5. вставьте скопированный код и отправьте его боту отдельным сообщением;
6. дождитесь подтверждения, что входящее сообщение получено и ответ успешно доставлен.

После успешной проверки бот подключён и готов к дальнейшей настройке.

Что делать при ошибке

• Неверный или отозванный токен. Скопируйте действующее значение из MAX и повторите подключение без пробелов до и после токена.
• Бот ещё не готов на стороне MAX. Проверьте состояние в MAX для бизнеса и дождитесь завершения требуемой проверки.
• Не удалось настроить получение сообщений. При подключении бота необходимые технические настройки выполняются автоматически.
  Если система сообщает, что получение сообщений настроить не удалось, подождите несколько минут и повторите проверку подключения.
• Временная ошибка или ограничение частоты запросов. Не создавайте дубликат проекта. Подождите несколько минут и повторите проверку.
• Проверка не завершается. Укажите поддержке название проекта, время и видимый текст ошибки, но не присылайте токен.

Официальное описание API и текущих ограничений MAX находится в документации API MAX.

Как заменить скомпрометированный токен

Если есть подозрение, что токен бота мог попасть к постороннему человеку, сначала обновите его в настройках бота MAX.

После этого:

1. откройте нужный проект в кабинете;
2. перейдите в настройки подключения;
3. укажите новый токен;
4. сохраните изменения;
5. повторите проверку связи с ботом.

После сохранения нового токена система автоматически проверит подключение и обновит необходимые технические настройки.

Важно: старый токен после замены больше не используйте. Новый токен также нельзя публиковать, показывать на скриншотах или передавать посторонним.

Что делать дальше?

После успешной живой проверки бот подключён и готов к дальнейшей настройке.

Если вы подключали бота через «Первый запуск», у вас уже создан и проверен простой сценарий для получения заявок. Его можно использовать как основу: изменить вопросы, добавить нужные поля и настроить дальнейшую работу с заявками.

Если бот был подключён через раздел «Проекты», следующим шагом выберите, что именно он должен делать.
Например:

• принимать заявки;
• показывать интерактивное меню;
• вести пользователя по сценарию;
• отвечать на вопросы;
• открывать мини-приложение;
• работать с сообщениями, группами и каналами.

Не обязательно настраивать всё сразу. Для первого запуска лучше выбрать одну задачу, полностью пройти её самостоятельно как обычный пользователь и убедиться, что результат корректно появляется в кабинете.