Подключение к платформе MAX и её сервисам — чат-ботам, мини-приложениям, каналам — доступно для юрлиц и ИП, которые являются резидентами РФ.
Чтобы создать бота, вы сначала должны подключиться к платформе MAX, создать и верифицировать профиль организации.
Для одной организации доступно создание 5 ботов.
Каждый из ботов настраивается и проходит модерацию отдельно. Несколько ботов могут понадобиться, если, например, у компании несколько подразделений и вы хотите взаимодействовать с пользователями от имени каждого из них, или вам нужны разные сценарии диалогов ботов.
Ник создаётся автоматически по шаблону idИНН_bot. Остальные поля нужно заполнить самостоятельно. После создания и проверки бота можно отредактировать все данные, кроме ника.
В содержимом полей и логотипе запрещено использовать ненормативную лексику, контент 18+ и данные других компаний. Описание должно соответствовать деятельности вашей организации.
| Поле | Обязательность | Описание и формат |
|---|---|---|
| Название | Да | Название чат-бота, которое отображается в MAX Формат: - Длина: 1 — 59 символов - Допустимые символы: латиница, кириллица, цифры - Эмодзи не поддерживаются |
| Ник | Да | Никнейм, который отображается в публичной ссылке на чат-бот, например: ник — idИНН_bot, публичная ссылка — https://max.ru/idИНН_bot Ник генерируется автоматически по шаблону idИНН_bot Выбрать или изменить его пока нельзя. Когда такая возможность появится, обратите внимание на требования к нику: - Должен заканчиваться на «_bot» или «bot» - Длина: 11 — 60 символов, включая «_bot» / «bot» - Должен начинаться с маленькой буквы, без @ - Допустимые символы: латиница, цифры и _ |
| Сайт | Нет | Сайт организации Формат: - Длина: не более 1024 символов - Должен начинаться с https:// - Допустимые символы: латиница, цифры, точка, дефис - Пробелы не поддерживаются |
| Логотип | Да | Логотип, который отображается в качестве аватара чат-бота в MAX. Загрузите изображение — после этого вы сразу сможете кадрировать его под необходимые требования прямо на платформе Формат: - Размер: 500х500 px - Не более 5 Мб - Cоотношение сторон: 1:1 - Формат файлов: .jpg, .jpeg, .png |
| Описание | Да | Краткое описание задач, которые решает чат-бот, а также основных функций, преимуществ для клиентов и особенностей использования Формат: - Длина: не более 200 символов - Допустимые символы: латиница, кириллица, типовые и спецсимволы, пробелы, эмодзи |
| Телефон компании | Нет | Телефон организации. Для каждого чат-бота можно задать собственный номер Формат: - Длина: не более 12 символов, включая + - Должен начинаться с +7 - Пример: +7 (999) 999-99-99 |
После создания бот проходит модерацию — появляется статус «на модерации». Проверка занимает до 48 часов по рабочим дням. Ход модерации можно отслеживать по статусам:
| Статус модерации | Описание |
|---|---|
| «на модерации» | Бот находится в процессе модерации Проверка занимает до 48 часов по рабочим дням Вы не можете изменить настройки бота, пока он находится в этом статусе |
| «создан» | Бот успешно прошёл модерацию Теперь вы можете выбрать и настроить сервисы При необходимости вы можете изменить настройки бота в его карточке на платформе — тогда бот перейдёт в статус «на модерации» |
| «требует исправлений» | Бот не прошёл модерацию Ознакомьтесь с причиной отказа в настройках бота (его карточке), внесите необходимые изменения и повторно отправьте данные на проверку |
После успешной модерации бот получает статус «создан». Теперь пользователи могут найти чат-бот по нику (например @idИНН_bot) через поиск в MAX.
После успешной проверки бота в разделе Интеграция → Получить токен кабинета MAX появится токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API MAX, и произвести интеграцию с платформой TWIN. Наличие токена означает, что бот зарегистрирован на платформе MAX.
Токен — это прямой доступ к боту. Не рекомендуем хранить его в открытых источниках или передавать посторонним — они смогут завладеть ботом и управлять им от вашего имени. Если вы опасаетесь, что токен скомпрометирован, обновите его.
Бот подготовлен к интеграции. Теперь вы можете скопировать полученный токен, и интегрировать бота в TWIN согласно инструкции по интеграции с Max.