Мессенджер МАХ

Регистрация и верификация в МАХ

~~Проверка регистрации компании на ресурсе~~ ~~МСП~~

~~Документация платформы~~ ~~МАХ~~

Как подключиться в МАХ

~~Войдите на платформу или зарегистрируйтесь~~

Этап 1. Вход на платформу

~~Регистрация на~~ ~~платформе~~ ~~только по номеру телефона с подтверждением через SMS-код.~~

~~Если вы уже зарегистрированы, используйте свои данные для входа (телефон).~~

~~Если вы впервые на~~ ~~платформе~~:

~~Укажите номер телефона — рекомендуем использовать корпоративный номер вашей организации.~~ ~~Введите код из SMS, который мы пришлём на этот номер.~~ ~~Готово! Вы авторизовались на платформе.~~

Одному номеру телефона соответствует один профиль организации и привязанные к нему сервисы: чат-боты, мини-приложения, каналы и сервисы партнёров.

~~Что делать, если есть регистрация на МСП.РФ, но войти на платформу не получается~~

~~Войдите в профиль организации или создайте организацию~~

Этап 2. Вход в профиль организации

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

~~Создание организации:~~

~~Если у вас ещё нет подходящего профиля организации, платформа предложит создать новый:~~

~~Введите ИНН вашей организации (10 или 12 цифр), нажмите Далее → Создать и следуйте инструкциям на экране.~~

~~Пройдите верификацию~~.

~~Верификация организации:~~

Пройденная верификация подтверждает, что ваша организация зарегистрирована официально. Верификация доступна для юрлиц и ИП, которые являются резидентами РФ. Её может пройти только владелец организации — единоличный исполнительный орган — или представитель с правом первой или единственной подписи.

~~Если организация не верифицирована, вы увидите экран~~ ~~Подтвердите организацию~~~~. Чтобы пройти верификацию и получить доступ к сервисам платформы:~~

~~Нажмите~~ ~~Подтвердить~~ ~~— вы перейдёте в~~ ~~личный кабинет организации~~. Выберите способ подтверждения (через Госуслуги или банковские сервисы Аlfa ID, Т-Business ID, СберБизнес ID) и проверьте, что выполняются условия подключения.

~~Справа от выбранного сервиса нажмите~~ ~~Подключить~~. ~~Авторизуйтесь в аккаунте сервиса.~~ Если вы используете для верификации способ подтверждения через Госуслуги и у вас несколько организаций, то укажите нужную в окне выбора организации. В этом окне на Госуслугах отображаются только те организации, ИНН которых совпадает с ИНН в профиле на платформе MAX для партнёров. Подтвердите согласие на передачу данных о вашей организации с помощью SMS-кода. Подтверждение обычно занимает несколько минут.

~~Если подтвердить организацию не удалось:~~

~~Напишите нам на почту~~ ~~partner_support@max.ru~~ ~~и укажите:~~

~~ИНН вашей организации.~~ Последовательность действий, которые вы выполняли. По возможности приложите в письмо скриншот ошибки — это поможет нам быстрее найти решение. ~~Готово! Вернитесь на~~ ~~платформу~~ и ~~выберите сервис для интеграции. Это может быть бот, канал, мини-приложение или сервис партнёров.~~

~~Статусы верификации:~~

~~Статус верификации отображается рядом с названием организации в платформе MAX для партнёров~~

~~Статус верификации~~ ~~Аватар организации~~

~~Организация не подтверждена~~

~~Организация подтверждена~~

~~Если у вас остались вопросы по верификации, посмотрите ответы на часто задаваемые вопросы в~~ ~~FAQ~~ ~~или напишите нам на почту.~~

Cоздание чат-бота

Чтобы создать бота, вы сначала должны подключиться к платформе MAX для партнёров, создать и верифицировать профиль ~~организации~~организации.

~~пункт~~

Регистрация 1.и верификация в МАХ

Чтобы создать бота можно воспользоваться документацией.

Для одной организации доступно создание 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

Каждый бот должен пройти модерацию.

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

Далее в Метабот необходимо будет передать токен созданного ~~бота~~бота.

иПосле ~~ссылку~~модерации навам станут доступны раcширенные настройки бота и ~~QR-код.~~мини-приложения. Чтобы посмотреть их, перейдите в раздел платформы Чат-бот и мини-приложение → Настроить

Расширенные настройки бота:

Управление приватностью бота — вы можете разрешить или запретить добавление бота в групповые чаты. По умолчанию стоит запрет; Кнопка запуска мини-приложения — вы можете выбрать один из вариантов: Открыть, Старт, Играть или без названия (по умолчанию).

Cоздание канала на Метабот

Перейдите в Настройки бота в раздел подраздел Каналы.

Нажмите кнопку Новая привязка и выберите канал MAX.

Добавьте токен и установите настройки работы с кнопками/файлами.

Остальные параметры можете заполнить по желанию:

Использовать inline-кнопки — вместо списка вариантов в боте будет выводиться inline-кнопка отдельно для каждого варианта из меню;
Реакция на фото — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать фото отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для фото — контекст NLP для реакции на фото;
Отключить Fallback для фото — при игнорировании фото, не активировать для него Fallback скрипт;
Реакция на файлы (документы) — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать файлы отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для файлов (документов) — контекст NLP для реакции на файлы;
Отключить Fallback для файлов (документов) — при игнорировании файлов, не активировать для них Fallback скрипт;
Реакция на видео — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать видео отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для видео — контекст NLP для реакции на видео;
Отключить Fallback для видео — при игнорировании видео, не активировать для него Fallback скрипт;
Реакция на аудио — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать аудио отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для аудио — контекст NLP для реакции на аудио;
Отключить Fallback для аудио — при игнорировании аудио, не активировать для него Fallback скрипт;
Реакция на голосовые сообщения — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать голосовые сообщения отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для голосовых сообщений — контекст NLP для реакции на голосовые сообщения;
Отключить Fallback для голосовых сообщений — при игнорировании голосовых сообщений, не активировать для них Fallback скрипт;
Реакция на стикер — в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать стикеры отправленные пользователем, либо реагировать при помощи NLP или выводом меню;
Контекст NLP для стикера — контекст NLP для реакции на стикеры;
Отключить Fallback для стикера — при игнорировании стикера, не активировать для него Fallback скрипт.

Если оставить настройки файлов без изменений, то бот будет реагировать на них вызовом Fallback-а.

Сгенерируйте Вебхук и создастся привязка с данными бота.

Не забудьте сгенерировать Вебхук в поле Операции, иначе операция привязки бота к каналу не будет завершена.

Подключение к каналу завершено. Теперь можно проверить запуск бота.