Разработчикам

Чат-боты и мини-приложения MAX: API, кнопки, Webhook и Long Polling, MAX Bridge, диплинки и подключение к платформе для партнёров. Только по документации dev.max.ru.

Реклама

VDSina · РФ · VPS/VDSVPS от 150 ₽ в месяцNVMe, бесплатная защита от DDoS и посуточная оплата. Москва или Амстердам.Скидка 10%Рекламодатель: ООО «Хостинг-технологии»

Найти в разделе

ВсеИнструкция 59Если не работает 2

AndroidiPhoneВеб

61 материал

Старт: бот через APIСообщения, кнопки и событияНастройки и права ботаМини-приложения и MAX BridgeДиплинкиПлатформа для партнёров и верификация

Старт: бот через API 11

• Первый чат-бот MAX через API: от токена до ответа

  Минимальный путь разработчика: верификация, создание бота, токен, запросы к platform-api2.max.ru, Long Polling для тестов и Webhook для продакшена.

• Как создать бота?

  Бота в MAX создают на платформе для партнёров с верифицированным профилем: 5 ботов для ИП и юрлиц, 2 для самозанятых.

• Как создать своего чат-бота в MAX?

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

• Как создать чат-бот через бот «MAX для бизнеса»?

  Как создать чат-бот через бот MAX для бизнеса в мессенджере MAX: официальная инструкция.

• MAX messenger bot API

  Как получить токен бота MAX, открыть документацию dev.max.ru и проверить webhook.

• Мессенджер max api для ботов

  Как получить токен MAX Bot API, выбрать long polling или webhook и проверить доставку.

• Max мессенджер создать бота

  Свой бот в MAX — юрлицам, ИП и самозанятым РФ через партнёрскую платформу и @MasterBot. Физлицу без статуса бота не дают.

• Как посмотреть токен бота?

  Как посмотреть токен бота в мессенджере MAX: официальная инструкция.

• Как обновить токен бота?

  Как обновить токен бота в мессенджере MAX: официальная инструкция.

• Как узнать токен через бот «MAX для бизнеса»?

  Токен бота можно получить в боте «MAX для бизнеса» после верификации профиля и модерации бота через мини-приложение.

• Канал и бот из Telegram в MAX: что работает иначе

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

Сообщения, кнопки и события 6

• Кнопки в чат-боте MAX: inline-клавиатура через API

  Типы кнопок бота MAX (callback, link, message, open_app, request_contact, clipboard), лимиты клавиатуры, ответ на нажатие через POST /answers и проверка номера телефона по hash.

• Чем Long Polling отличается от Webhook-подписок?

  Получение обновлений с помощью Long Polling ограничено по скорости и сроку хранения событий — этот способ не подходит для production-окружения.

  Если не работает
• Почему не приходят уведомления Webhook?

  Почему бот MAX не получает события Webhook: HTTPS и порт 443, сертификат, ответ 200 за 30 секунд, права в чате и автоотписка через 8 часов.

  Если не работает
• Можно ли форматировать текст в сообщениях бота?

  Платформа поддерживает два типа форматирования — Markdown и HTML.

• Есть ли у чат-ботов в MAX команды по умолчанию, предзаданные платформой?

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

• Как узнать, получают ли пользователи уведомления от чат-бота?

  Пока разработчики не могут отслеживать пользовательские настройки уведомлений в чат-боте.

Настройки и права бота 10

• Как управлять ботом в MAX?

  После модерации скопируйте токен бота на платформе MAX: Чат-боты → ⋮ → Настройки. Токен нужен для API.

• Как изменить имя, аватар, описание и другие настройки бота?

  Вы можете изменить настройки бота только после прохождения модерации.

• Есть ли ограничения для никнейма и имени бота?

  Никнейм генерируется автоматически: Выбрать или изменить его пока нельзя.

• Можно ли поменять владельца бота?

  Поменять владельца или передать права на управление ботом пока нельзя.

• Можно ли сделать непубличного бота?

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

• Как удалить бота?

  ℹ️ После удаления ваши клиенты не смогут пользоваться ботом.

• Как разрешить или запретить добавление бота в групповой чат?

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

• Как создать групповой чат, добавить бота в чат и назначить бота администратором?

  Как разрешить добавление бота в группы на платформе MAX, добавить его в чат и выдать права администратора.

• Как назначить бота администратором канала?

  Как назначить бота администратором канала в мессенджере MAX: официальная инструкция.

• Как добавить бота в канал?

  Подробнее о добавлении бота в групповые чаты и каналы — на странице Добавление бота в чаты и каналы

Мини-приложения и MAX Bridge 10

• Мини-приложение MAX на MAX Bridge: быстрый старт

  Путь разработчика от HTML-страницы до мини-приложения в MAX: хостинг по https, подключение к боту, библиотека max-web-app.js, стартовые параметры, проверка initData и номера телефона.

• Как подключить мини-приложение к MAX?

  Требования к URL мини-приложения: Подробнее об интеграции мини-приложений — в разделе Как добавить мини-приложение в MAX.

• Можно ли добавить мини-приложение в MAX без чат-бота?

  Нет, подключить дополнительные сервисы к MAX, управлять ими и запускать можно только с помощью чат-бота.

• Можно ли обновлять опубликованное мини-приложение?

  Да, вы можете вносить изменения, если у мини-приложения статичный URL.

• Есть ли ограничения на контент для мини-приложений?

  Ограничения есть. Внимательно изучите Правила платформы перед размещением мини-приложения в MAX и убедитесь, что оно безопасно для пользователей и.

• Как изменить кнопку открытия приложения?

  Как изменить кнопку открытия приложения в мессенджере MAX: официальная инструкция.

• Как обновить ссылку на приложение?

  Как обновить ссылку на приложение в мессенджере MAX: официальная инструкция.

• Как скачивать файлы с помощью MAX Bridge?

  В мини-приложении MAX скачивайте файл через window.WebApp.downloadFile, а не через обычный href.

• Как скачивать файлы без использования MAX Bridge?

  Если MAX Bridge недоступен, мини-приложение может скачать файл через fetch и Blob. Не смешивайте оба способа в одном клике.

• Как обновить токен Цифрового ID?

  Токен Цифрового ID действует 1 год. Как обновить его и что будет с подключёнными магазинами и торговыми точками.

Диплинки 5

• Что такое диплинки в MAX?

  Диплинки (deep links) — это специальные ссылки, которые позволяют открывать чат-ботов или мини-приложения MAX с передачей дополнительных параметров.

• Как создать диплинк для чат-ботов?

  Диплинк чат-бота MAX: https://max.ru/<никнейм>?start=<данные>. Никнейм бота и payload до 128 символов.

• Как создать диплинк для мини-приложения?

  Диплинк мини-приложения MAX: https://max.ru/<имя_бота>?startapp=<данные>. Имя бота и payload до 512 символов.

• Как создать диплинк для шеринга текста?

  Диплинк шеринга в MAX: https://max.ru/:share?text=. Открывает экран «Отправить в MAX» с готовым текстом.

• Какие версии клиентов MAX поддерживают диплинки?

  Механизм диплинков поддерживается в следующих версиях клиентов MAX.

Платформа для партнёров и верификация 19

• Кто может подключиться к платформе MAX для партнёров?

  К платформе MAX для партнёров подключаются юрлица, ИП и самозанятые — резиденты РФ. Цифровой ID — только юрлица и ИП.

• Кому доступна верификация на платформе MAX для партнёров?

  Верификация на платформе MAX для партнёров доступна юрлицам, ИП и самозанятым — резидентам РФ. Физлицам пока нет.

• Как стать партнёром?

  Обратите внимание на требования к заполнению формы - Укажите название сервиса ( обязательно ).

• В чём отличия при работе с платформой для самозанятых и организаций, ИП?

  Самозанятым на платформе MAX доступно 2 бота и 1 публичный канал, ИП и юрлицам — 5 ботов и до 10 каналов. Другие отличия.

• Какой номер телефона указать при регистрации на платформе для партнёров?

  На платформе MAX для партнёров указывайте рабочий номер ответственного представителя: на него приходят коды и уведомления.

• Не приходит SMS с кодом подтверждения при входе или регистрации на платформе MAX для партнёров

  Не приходит SMS для входа на платформу MAX для партнёров: отключите VPN, смените сеть, проверьте телефон и напишите в поддержку.

• Как пройти верификацию в мини-приложении «MAX для бизнеса»?

  Верификация в мини-приложении «MAX для бизнеса» проходит только через Госуслуги. Шаги и что откроется после проверки.

• Как пройти верификацию с помощью бота «MAX для бизнеса»?

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

• Как при верификации выбрать нужную организацию, если к Госуслугам привязано несколько организаций?

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

• При верификации организации, ИП или самозанятого через Госуслуги появилось окно «Что-то пошло не так»

  Самая распространённая причина ошибки — невыполнение необходимых условий на Госуслугах На Госуслугах у вас должен быть личный кабинет.

• При верификации организации, ИП или самозанятого появилось окно «Организация уже верифицирована»

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

• У меня проблемы при подтверждении организации, ИП или самозанятого на платформе, что делать?

  Не получается подтвердить организацию, ИП или самозанятого: проверьте номер для входа и данные в личном кабинете Госуслуг.

• Как отправить повторную заявку на партнёрство?

  Как отправить повторную заявку на партнёрство. Отправить заявку повторно пока нельзя.

• Как посмотреть и отредактировать заявку на партнёрство?

  Отправить заявку повторно, посмотреть или отредактировать уже отправленную пока нельзя.

• Как узнать статус рассмотрения заявки на партнёрство?

  Узнать статус рассмотрения через платформу нельзя.

• Ошибка при отправке заявки на партнёрство, что делать?

  Обратите внимание, что пока через платформу можно отправить только одну заявку.

• Как интегрироваться с сервисом партнёра?

  После подключения к платформе создайте бота и пройдите его модерацию.

• Как найти сервис партнёра на платформе?

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

• На платформе нет нужного сервиса, что делать?

  Посмотрите другие сервисы в подходящей категории — возможно, один из них вам подойдёт.