Диплинки

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

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

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

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

  • iOS: версия 2.7.0 и выше
  • Android: версия 2.9.0 и выше
Как создать диплинк для чат-ботов?

Используйте следующий формат ссылки:

Код
Скопировать
https://max.ru/<botName>?start=<payload>

Где:

  • <botName> — ник бота
  • <payload> — дополнительные данные (до 128 символов)

Подробнее о диплинках ботов читайте в разделе «Бот без разработки»

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

Используйте следующий формат ссылки:

Код
Скопировать
https://max.ru/<botName>?startapp=<payload>

Где:

  • <botName> — имя бота, к которому привязано мини-приложение
  • <payload> — необязательный параметр с дополнительными данными (до 512 символов)

Подробнее о диплинках приложений читайте в разделе «Подключение мини-приложения»

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

Используйте следующий формат ссылки:

Код
Скопировать
https://max.ru/:share?text=<текст сообщения>

Где:

  • text — текст, который пользователь отправит в выбранный чат или канал

Диплинк :share открывает экран «Отправить в MAX» и подставляет переданный текст в поле сообщения. Применяйте URL encoding для параметра text, если текст содержит пробелы, спецсимволы или эмодзи

Подробнее о диплинке :share читайте в разделе «Подключение мини-приложения»