Как подключить сервис к MAX

1. Зарегистрируйтесь и подтвердите профиль

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

1. Откройте MAX для партнёров. Для первого входа укажите рабочий номер телефона, к которому у вас есть постоянный доступ, и самостоятельно введите код из SMS. Если вы уже зарегистрированы, войдите в существующий аккаунт.
2. Создайте профиль организации, ИП или самозанятого. Подключение доступно резидентам РФ; физические лица без такого статуса и нерезиденты пока не проходят верификацию.
3. Подтвердите профиль доступным в интерфейсе способом. Для организации или ИП предусмотрены Госуслуги и банковские сервисы; для самозанятого — Госуслуги. Организацию подтверждает руководитель или представитель с необходимым правом подписи.
4. Дождитесь подтверждения профиля. Изучите и самостоятельно примите применимые документы MAX, если платформа предлагает это сделать.

Подробности и действия при ошибках: официальная инструкция по регистрации и верификации.

2. Создайте чат-бота и пройдите модерацию

1. В подтверждённом профиле откройте «Чат-боты» и нажмите «Создать».
2. Укажите название, описание и логотип, соответствующие вашей деятельности. Требования к полям показывает платформа; никнейм формируется автоматически.
3. Отправьте бота на модерацию. При замечаниях внесите исправления в его карточку и повторите проверку.
4. Дождитесь успешной модерации: после неё становятся доступны настройки и токен. Если бот уже создан и прошёл проверку, используйте его.

Подробнее: создание и модерация бота. Для мини-приложения потребуется привязка к боту; её параметры согласуем в проекте.

3. Получите токен выбранного бота

1. В личном кабинете MAX откройте «Чат-боты».
2. Выберите нужного бота и откройте меню «⋮ → Настройки».
3. В разделе с токеном доступа нажмите значок копирования. Проверьте, что это бот именно вашей организации и нужного проекта.

Токен даёт доступ к управлению ботом через API. Не размещайте его в исходном коде сайта, общедоступном репозитории, URL, скриншотах или заявке на разработку. Пароли, SMS-коды, cookies и доступ к личному аккаунту для интеграции не передаются.

Источник: получение и обновление токена в документации MAX.

4. Согласуйте передачу токена и подключение

1. Напишите на admin@edzsoft.ru без токена: укажите организацию, публичную ссылку на бота, задачу и контакт ответственного сотрудника.
2. До передачи доступа согласуем договор, сценарии интеграции, перечень данных, права доступа, хранение и удаление. Если EdZSoft обрабатывает персональные данные по поручению заказчика, поручение и необходимые меры защиты оформляются до начала обработки.
3. Согласуем конкретный защищённый способ передачи и проверим получателя. В контуре заказчика токен можно внести непосредственно в его хранилище секретов; если токен передаётся EdZSoft, используйте согласованный защищённый канал с ограничением доступа. До согласования канала токен не отправляйте.
4. Передайте только токен согласованного бота. Мы используем его для предусмотренной договором интеграции через официальные API MAX. Личный аккаунт и подтверждение действий остаются под вашим контролем.
5. Вместе проверим работу на тестовом сценарии и согласуем запуск. Изменение прав, подключение сторонних обработчиков и новые сценарии требуют отдельного согласования в рамках проекта.

На этой странице нет формы приёма токенов. Передача ключа не заменяет договор и не означает передачу владения аккаунтом.

5. Защита доступа, обращения и отключение

Если токен мог попасть посторонним: в настройках бота нажмите значок обновления рядом с токеном, приостановите интеграцию и сообщите EdZSoft на admin@edzsoft.ru. Не прикладывайте сам ключ. Новый токен подключается только согласованным защищённым способом.

При выявлении признаков нарушения безопасности EdZSoft приостанавливает использование API и незамедлительно уведомляет MAX по адресу partner@max.ru в соответствии с пунктами 4.1.12–4.1.13 условий. Для сообщений о неисправностях или недопустимом контенте укажите ссылку на бота, время события и описание, исключив секреты и лишние персональные данные.

Если сотрудничество завершено: сообщите об отключении, обновите токен и согласуйте прекращение доступа интеграции. EdZSoft прекращает использование токена и API для проекта; полученные через API данные удаляются либо обезличиваются в разумный срок, кроме случаев обязательного хранения по закону или договору. Порядок и сроки фиксируются в документах проекта.

Какие условия учитываем при разработке

• Используем документированные сценарии и соблюдаем лимиты API. Обход ограничений, массовое извлечение данных, фиктивные аккаунты и миграция клиентов на аналогичные платформы через API не входят в услуги.
• API MAX не используется для обучения моделей машинного обучения. ИИ-функции проектируются отдельно с учётом разрешённых целей, оснований обработки и ограничений передачи данных.
• Данные, полученные через API, не используются для рекламного таргетинга, показа рекламы и иных маркетинговых целей.
• Сервисные, авторизационные, транзакционные и массовые сообщения подключаются только в случаях, прямо предусмотренных договором заказчика с MAX. Наличия технической возможности недостаточно.
• До публикации конкретного бота или мини-приложения должны быть определены правообладатель и оператор, доступны контакты поддержки, условия использования и политика обработки персональных данных; при необходимости — возрастная маркировка и правила пользовательского контента.

Эта инструкция описывает порядок подключения. Условия использования и политика обработки данных конкретного приложения оформляются с учётом его функций, оператора и фактических потоков данных.

Документы и поддержка

• Условия технического взаимодействия MAX для партнёров
• Документация API MAX
• Стандартные условия договоров MAX
• Общие условия лицензии
• Правила размещения ботов и мини-приложений
• Требования к содержанию и функциональности
• Пользовательское соглашение MAX и политика конфиденциальности MAX

Вопросы по проекту, безопасности и содержимому разработанных нами решений: admin@edzsoft.ru. Вопросы регистрации на платформе: поддержка MAX для бизнеса.

Реквизиты и контакты EdZSoft · Вернуться к услугам разработки для MAX