Все гайды

Подготовка и запуск

Чат-бот MAX — создание, модерация и токен

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

  • 3 мин
  • обновлено 23 июля
  • настройка

Чат-бот MAX полезен, когда бизнесу нужен отдельный диалог с клиентом — принять запрос, дать быстрый ответ, собрать данные или передать разговор менеджеру. Сначала владелец создает и подтверждает бота на платформе, затем команда подключает сценарий и проверяет его на реальном сообщении.

Кто может создать бота

Платформа MAX для партнеров доступна резидентам России с подтвержденным профилем организации, ИП или самозанятого.

  • для одной организации или ИП доступно до 5 ботов;
  • для самозанятого доступно до 2 ботов.

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

Создайте карточку бота

  1. Откройте платформу MAX для партнеров и выберите подтвержденный профиль.
  2. Перейдите в раздел Чат-боты и нажмите Создать.
  3. Заполните карточку — название, логотип, описание и другие поля, которые показывает платформа.
  4. Еще раз проверьте, что описание совпадает с реальным сценарием, и отправьте бота на модерацию.

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

Дождитесь модерации

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

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

Где взять токен

Токен появляется только после успешной модерации.

  1. Откройте Чат-боты на платформе MAX для партнеров.
  2. Выберите нужного бота, если в профиле их несколько.
  3. Перейдите в Расширенные настройкиНастроить.
  4. Скопируйте значение из поля токена.

Токен дает доступ к управлению ботом через API. Не публикуйте его в чате, скриншоте, общей таблице или в репозитории. Передайте его исполнителю только защищенным способом, а в проекте храните в .env или другом секретном хранилище. Если есть подозрение, что токен увидел посторонний, обновите его в MAX и замените в проекте.

Что проверить до запуска

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

Если нужен не просто диалог, а прием и обработка запросов, сначала согласуйте маршрут автоматизации заявок. Для большого сценария полезно собрать ТЗ для Telegram-бота до настройки интеграции.

Первоисточники

Официальные документы