This document describes use cases for passing dynamic variables in broadcast messages using Smart Notifications API.

Developer documentation: https://docs.wildix.com/guides/2024/12/02/xhop-parameterized-action/.

Created: February 2025

Updated: March 2025

Permalink: https://x-hoppers.atlassian.net/wiki/x/DYBTCg

Use case 1: Request assistance at a self-checkout kiosk

Actors:

Precondition:

Postconditions:

Main Flow:

  1. The customer approaches the self-checkout kiosk.

  2. The customer faces an issue and decides to request assistance.

  3. The customer presses the "Request Assistance" button on the self-checkout interface.

  4. The kiosk system generates a URL associated with that specific device.

  5. The system sends a notification to the store associate’s headsets, indicating the location (self-checkout kiosk identifier) and the request for assistance.

  6. The store associate hears the notification and acknowledges it.

  7. The store associate proceeds to the specified self-checkout kiosk to assist the customer.

Use case 2: Click-and-collect

Actors:

Preconditions:

Postconditions:

Main Flow:

  1. The customer arrives at the store and accesses the tablet, the retailer’s proprietary app or web page via QR code.

  2. The customer inputs their order number or name.

  3. The system retrieves the order details and generates a notification.

  4. The system plays an announcement through the store associate’s headsets, stating, “Order number [order number] is ready to be collected by [customer name].”

  5. Store associate hears the announcement and prepares the specified order for the customer.

Use case 3: Pharmacy prescription pickup

Actors:

Preconditions:

Postconditions:

Main Flow:

  1. The customer arrives at the pharmacy and accesses the tablet, the pharmacy’s proprietary app or web page via QR code.

  2. The customer enters their personal details (name, date of birth, etc.).

  3. The system retrieves the prescription details associated with the entered information.

  4. The system plays an announcement through the pharmacist’s headset, stating the patient's name and other relevant details (e.g., “Prescription ready for [customer name], address [customer address].”).

  5. The pharmacist hears the announcement and retrieves the prescription without needing to ask the customer for information.