Clomni

Запуск сценария событием приложения (startFlow)

Обновлено: 22 октября 2026 · 5 мин чтения

Приложение может запустить сценарий само: например, кнопка «Проблема с заказом» на экране заказа. Когда приложение вызывает Clomni.startFlow, Clomni открывает новый диалог и запускает сценарий этого события. Этот триггер есть только в канале мобильного приложения (App SDK).

Шаги

  1. 1

    Настройте сценарий

    1. Campaigns › Flows › «New flow», канал мобильного приложения.
    2. «Settings» › «When it starts»: «App event».
    3. «Event name»: начинается со строчной латинской буквы, только строчные буквы, цифры и _, до 64 символов. Например order_problem. Одно имя события в канале принадлежит одному сценарию.
    4. «Expected data fields»: имена данных, которые пришлёт приложение, например order_id. Имя начинается с буквы или _.
    5. Постройте шаги, поставьте статус «Active» и нажмите «Publish».
  2. 2

    Вызов из приложения

    В «Settings» раздел «How the app calls it» показывает готовый код для Android, iOS, React Native и Flutter. Например:

    Clomni.startFlow("order_problem", mapOf("order_id" to "A-1042"), openMessenger = true, source = "order_screen")

    openMessenger = true сразу открывает мессенджер. Для события, которое пользователь не вызвал сам (например, неудачная оплата), оставьте false: пользователь узнает о сообщении по push или счётчику непрочитанных. source становится «Opened from» диалога, без него event:order_problem.

  3. 3

    Данные в тексте

    Данные пишутся как {{data.order_id}}, они есть и в «Insert a variable». Вложенное поле {{data.order.id}}. Данные это объект JSON до 8 КБ. Поле, которое приложение не прислало, остаётся пустым.

  4. 4

    Если не работает

    • В startFlow передаётся «Event name», а не название сценария.
    • Если у события нет активного опубликованного сценария, ничего не происходит, диалог не открывается.
    • Для пользователя вне «Who sees it» сценарий не запускается.
    • Сценарий с триггером «When a conversation starts» через startFlow не запускается.
  5. 5

    Событие сохраняется

    Даже без сценария событие хранится 90 дней. Проверка «App event» в шаге «Condition» выбирает путь по тому, присылало ли приложение пользователя это событие за последние N дней (от 1 до 90, по умолчанию 30).

Документ

Сценарии в мобильном приложении: руководство v1.0 · 71 стр. Открыть Скачать