How to generate and manage QR codes

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

Updated: May 2025

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. They receive audio notifications directly on their headsets, as well as text notifications via a mobile or web app. Once someone accepts a notification by double pressing the Push-to-talk button, the system informs everyone in the broadcast that the request is being handled by a specific associate. 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

  • x-hoppers system on WMS 7.0X and higher

  • A broadcast configured in x-hoppers admin -> Broadcasts

  • ACL rule “Can see x-hoppers” (enabled by default)

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 x-hoppers admin and navigate to Dialplan menu, Dialplan rules tab

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

x-hoppers smart notifications_Import Dilaplan.jpg

Create QR code

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

  • Access x-hoppers admin and navigate to Broadcasts menu, QR Code tab

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

x-hoppers QR codes Guide-Broadcast.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)

x-hoppers QR codes_Event name.png
  • Set the following mandatory parameters:

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

    • Broadcast: Select the broadcast where the message is played

    • Play 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

x-hoppers QR codes_Set parameters_upd.png
  • 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. and 9. 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

x-hoppers QR codes_Manage QRs_upd.png