How to generate and manage QR codes

This guide provides step-by-step instructions for generating and managing x-hoppers QR codes.

Created: October 2024

Useful resources:

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

Introduction

x-hoppers allows you to create QR codes linked to products or store departments, which the x‑hoppers system logs each time they’re scanned. When a customer scans a QR code in a specific section of the store, store associates are instantly notified that assistance is needed in that area. In addition to sending audio alerts to x-hoppers headsets, QR codes can direct customers to a dedicated webpage, providing them with detailed product information. This ensures quick response times, improving customer satisfaction and in-store support.

Requirements

Configuration

Import a dedicated Dialplan procedure

Before creating QR codes, you need to import the dedicated Dialplan procedure, required for sending audio alerts to employees every time a QR code is scanned.

  • Download the provided procedure:

  • Access WMS and navigate to Dialplan menu, Dialplan rules tab

  • Click Import, select the procedure and click Apply to finish

x-hoppers QR codes_Import Dilaplan-upd.jpg

Create QR code

Once the Dialplan procedure is imported, you can proceed to create a QR code.

  • Access WMS and navigate to x-hoppers menu

This menu is available only for admin users on PBXs with x-hoppers licenses and ACL rule “Can see x-hoppers” (enabled by default).

x-hoppers QR codes.jpg
  • Click Add to create a new QR code

  • Enter a name for the event associated with this QR code and select Broadcast message type (support for additional types is planned for future releases)

  • Set the following mandatory parameters:

    • Message: Enter the message to be broadcasted to all employees with x-hoppers headsets once the QR code is scanned

    • PBX: Select the appropriate PBX (if multiple PBXs are available in WMS network)

    • Broadcast ID: Specify the broadcast ID number (conference room number) where the message is played

    • Message frequency: Specify how often the broadcast message should be repeated

    • Confirmation timeout: Set the duration before the playback of the broadcast message is cancelled. After the timeout expires, the system message The request timed out is played to employees

    • Queue timeout: Define how long the broadcast message remains in the queue of other requests

  • Apply the following optional customization:

    • Welcome message: Enter a welcoming message to greet customers after scanning the QR code. The default message is Thank you! Your request has been received and is being processed

    • Redirection URL: Provide a URL to which customers are redirected in 5 seconds after scanning the QR code

  • Click Add to save the QR code

QR codes management

After creating the QR code, you can:

  1. Select: Select one or multiple QR codes to perform additional actions (duplicate, delete)

  2. Duplicate: Create an exact copy of the QR code

  3. Delete: Remove the QR code(s) from the system

  4. Search: Find specific QR codes by name, type, date

  5. Copy URL: Copy the QR code's URL for sharing or distribution. You can use the URL to create your own customized QR code

  6. Download: Download the QR code image

  7. Test play: Play the associated broadcast message to ensure it’s working correctly. For that, you need to be connected to the broadcast channel

  8. Edit: Modify the details of the QR code as needed