How a flow works in the mobile app: status, agents, Back, versions

Last updated: 22 October 2026 · 7 min read

In the mobile app (App SDK) a flow shows up in the messenger as messages and buttons. The flow runs on the server; the app only shows it.

Steps

  1. 1

    The conversation's status

    • While a “When a conversation starts” or “App event” flow runs, the conversation is “Pending” and not in the agents' queue.
    • “Hand to agent”: “Open”. “Close conversation”: “Resolved”. “Hand to AI agent”: stays “Pending”.
    • A path that ends on an ordinary step closes the conversation.
    • A “Manual” flow, a status flow and one Clomni AI started leave the status as it is and give it back at the end of the path.
  2. 2

    When an agent writes

    As soon as an agent writes a public reply in the conversation, the bot stops there and the app's text box opens. A private note does not stop the bot. The exception: a “Wait” step with “If the operator writes” goes on from “The operator wrote”.

  3. 3

    What the customer sees

    • Between the bot's messages the app shows the bot typing for 0.6 to 1.2 seconds. Agents' messages are not delayed.
    • Only the latest message's buttons work; older ones are greyed out.
    • If a waiting step came before, “← Back” shows under the buttons and asks that step again. “Back” does not go into another flow or back to the language choice.
    • The chosen button's name shows in the conversation as the customer's message.
    • If the bot passes 25 steps without asking anything, the flow stops there (a guard against loops).
  4. 4

    When a new version is published

    A conversation that has started finishes on the version it started with, even if a new version is published or the flow is deleted. Open a new conversation in the app to see a change.

  5. 5

    A long pause

    If a waiting step is left unanswered for more than 24 hours, the customer's next message is not taken as its answer: the step is asked again as a new message, and the old buttons stay greyed out.

  6. 6

    When the app hears about it

    When a flow ends the app gets onFlowCompleted: at the end of a path and when the conversation is handed to a person or the AI. Moving to another flow is not an end.

  7. 7

    SDK version

    From SDK 1.0.2, a choice with nothing after it ends the flow and opens the text box. The “Customer can't type” switch and the “Turn off typing” step work from SDK 1.0.4.

Document