Deep links в MAX: как приводить пользователя сразу в нужный сценарий
Разбираем deep links в MAX: что можно передать при открытии бота, как использовать ссылки в onboarding и где не стоит переусложнять первый сценарий.
Что такое deep links в MAX
Deep link это ссылка, которая открывает бота или mini app в нужном контексте. MAX поддерживает их официально, и это один из самых простых способов сократить путь пользователя до первого понятного действия.
По документации MAX deep links поддерживаются в клиентах iOS 2.7.0+ и Android 2.9.0+.
Форматы ссылок
Для бота используется формат:
https://max.ru/<botName>?start=<payload>Для mini app используется:
https://max.ru/<botName>?startapp=<payload>В документации указано, что для бота payload может быть длиной до 128 символов, а для mini app до 512.
Где это реально полезно
- Привести пользователя сразу в onboarding-сценарий без лишнего меню.
- Понять источник перехода: сайт, письмо, CRM, рекламный кабинет.
- Открыть готовый контекст: заказ, заявка, support-flow, промо-код.
https://max.ru/my_bot?start=order_1001
https://max.ru/my_bot?start=pricing_page
https://max.ru/my_bot?startapp=invite_teamЧто не стоит усложнять
Deep links полезны ровно до момента, пока вы не пытаетесь запихнуть в них половину бизнес-логики.
- Не кладите в payload чувствительные данные.
- Не стройте критичную безопасность только на start-параметре.
- Не делайте десятки ссылок, если пользователю нужен один понятный вход в сценарий.
Если после deep link вы хотите сразу принимать события, дальше логично читать про webhook и получение обновлений.
Создайте бесплатный MAX-профиль
Если хочется не просто читать, а сразу проверить сценарий руками: подключите MAX, отправьте себе тестовое сообщение и уже потом решайте, нужны ли другие каналы.