Wait for Cross-Session Message
Waits for another journey to complete a certain step before resuming the current flow.
Description
Cross-session messages allow journeys to securely share info and create dependent flows. This step is used in a journey to suspend the flow until a specific message is processed by another journey. It can also provide the message ID to the processing journey by displaying it as a QR code.
For example, a kiosk can create a message and display it as a QR while waiting for a mobile app to scan it. Scanning the QR can then initiate a journey that processes the message, allowing the kiosk to resume journey execution.
Once the message is processed, the journey proceeds to the next step. The journey can also access any response data added to the message by the processing journey. However, if the message is not processed before the wait timeout, the journey is aborted.
Note
Only a single journey can wait for a given message at one time.
Configuration
| Field | Description |
|---|---|
| Message ID | Expression yielding the message ID of the message to wait for. |
| Wait Timeout | Maximum period of time to wait for the message to be processed (in seconds), from when this step was initiated. Default is 300. |
| Output Variable | Name of the variable used to store the response data provided by the processing journey. This data can be used in subsequent journey steps, and can be found in the user_params object. Default is cross_session_message. |
| Message ID Format | Whether to display the message ID as a QR code, or not at all (default). |
| Message ID Display Mode | If a QR format is selected, this indicates whether it should encode the message ID directly or encode a custom expression that includes the message ID and possibly other info. |
| Message ID to Display | Custom expression that yields a value to encode in the QR code that is displayed to the user in the wait screen. This must include the message ID using the message_id variable and possibly other info. |
| Wait Message Title | Title for the wait screen. |
| Wait Message Text | Body for the wait screen. |