Передача меток из MAX Bot с использованием Deep Linking

Описание задачи

Есть несколько источников трафика, и необходимо определить, какой из них эффективнее.

Решение: использовать ссылки на MAX Bot с использованием механизма Deep Linking.

В параметр start можно передать дополнительные значения, например:

https://max.ru/YourBot?start=from_vk

или

https://max.ru/YourBot?start=from_landing

Где YourBot — ник вашего бота в MAX, а значение после start — метка, которую нужно передать в Nextbot.

Пошаговая настройка

1. К ИИ-Агенту подключен MAX Bot.

2. Предположим, что есть два источника трафика:

   • канал в MAX;

   • лендинг.

3. Для каждого источника создайте отдельную ссылку на бота с параметром Deep Linking:

   • Для канала в MAX:

     https://max.ru/YourBot?start=from_max

   • Для лендинга:

     https://max.ru/YourBot?start=from_landing

   (Замените YourBot на ник вашего бота в MAX.)

4. В функции для отправки результатов (например, в мессенджер или в CRM) выберите следующие параметры:

   • Имя переменной (Поле сделки) — желаемое название или поле сделки

   • Действия = Данные пользователя

   • Передаваемое значение = Переменные из запроса max /start

Пример выбора переменных из запроса MAX Bot /start

1. Проверим, как это работает.

   Перейдите по ссылке и откройте MAX Bot.

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

3. После этого проверьте отправленный отчёт или созданную запись в CRM. В выбранное поле должна передаться метка из ссылки, например from_max.

Где можно использовать метку

Параметр из запроса max /start можно использовать:

• в отчётах администратору;

• в действиях функций, например при передаче данных в CRM;

• в сценариях через условие MAX Bot: параметр /start;

• в Python Script, если соответствующее системное поле доступно в блоке комментариев шаблона.

Дополнительная информация по deep link

• Для MAX Bot используется формат https://max.ru/YourBot?start=payload.

• Максимальная длина параметра payload — 128 символов. Если параметр длиннее, MAX не передаст его боту.

• Не используйте специальные символы, требующие URL-кодирования (пробелы, кириллицу, спецсимволы).

• Для передачи нескольких параметров объединяйте их в одну строку с разделителем (_ или -).

Не путайте ссылки для MAX Bot с deep link для мини-приложений MAX. Для ботов используется параметр start, а для мини-приложений — startapp.

Пример:

https://max.ru/YourBot?start=source_landing_campaign_summer

Подробнее о формате deep links смотрите в официальной документации MAX.