Работа с командами в чат-боте MAX

При настройке Условий отправки в чат-боте для MAX есть возможность выбрать команду, после которой будет запускаться сценарий бота. По умолчанию доступна команда /start, а также вариант "Начало нового вопроса в диалоге"  (подойдет для клиентов, которые ранее уже обращались к вам в MAX и прошли сценарий стартового бота).

В настройках интеграции MAX вы также можете создать свои команды, чтобы запускать по ним другие сценарии.

1. Перейдите к настройкам интеграции MAX
2. Выберите вкладку "Список команд" и нажмите кнопку "Создать команду" справа вверху.
3. Откроется следующее поле:
   
4. Укажите название команды без символа /, например, custom_command, и ее описание (для внутреннего использования). Нажмите на галочку для сохранения команды.

После того, как команда появилась в списке, можно переходить к использованию ее в самом чат-боте, на шаге "Условия отправки":Если у вас создано несколько команд, зажав кнопку слева от команды, вы сможете поменять позицию команды в списке. Это влияет на порядок отображения команд при выборе их в боте.

Использование команд со стороны пользователя

Чтобы у пользователя запускался сценарий чат-бота в MAX по нужной команде, ему нужно перейти в MAX по ссылке, сформированной определенным образом:

https://max.ru/<bot_id>?start=cqc_/название_команды

Вместо bot_id в ссылку нужно добавить id вашего бота в MAX. Id бота можно найти в его описании:

пример id бота при просмотре в веб-версии

Передача UTM-меток через MAX-бота

Таким же образом вы можете передавать UTM-метки, чтобы отслеживать источник перехода в бота. 

Для передачи UTM-меток должен использоваться специальный синтаксис. Пример:

https:///max.ru/<bot_id>?start=cqi_utm_source=google-cqi_utm_medium=cpc-cqi_utm_campaign=summer

Ограничения при создании ссылок / команд

• Параметр должен иметь до 128 символов после знака =
• Используйте латиницу и нижнее подчеркивание _ вместо пробелов
• при указании команд используйте знак / (cqc_/command_name)

Примеры готовых ссылок

• Запуск конкретного сценария (команда) 

https://max.ru/<bot_id>?start=cqc_/название_команды

• Команда + передача UTM 

https://max.ru/<bot_id>?start=cqc_/название_команды-cqi_utm_source=google-cqi_utm_medium=cpc

• Команда для передачи свойств пользователя и их значений, а также событий вместе с командой (помните про ограничение в 128 символов)

https://max.ru/<bot_id>?start=cqc_/название_команды-cqi_свойство=значение_свойства-cqe_событие