How to set up x-hoppers integration with Flic

This guide explains how to configure x-hoppers integration with Flic, solution that provides small wireless push buttons used to control apps and services.

Created: July 2024

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

Introduction

x-hoppers integration with Flic allows to use Flic button as a help point trigger. After pressing the button, broadcast users get an audio notification that help is required at a specific area, letting to quickly address the customer’s request for help.  

Requirements

  • SalesFloorHopper license or higher

  • Flic button and Flic app installed

How to set up

In the Flic application, fill out the following data on the POST tab:

  1. URL: Enter the following URL replacing {pbx-name} with your PBX

    https://{pbx-name}.wildixin.com/api/v1/Originate
  2. Content type: application/x-www-form-urlencoded

  3. Body: Enter the following data replacing {conf_number} with the relevant conference room ID number and entering the necessary announcement in the “text=” variable:

    channel=Local/conf*{conf_number}@pbxservices&context=playbackfiles&priority=1&exten=s&variable=text=Assistance required at button location. Assistance required at button location&callerid=1
  4. HTTP headers: For this section, you need to generate authorization token in WMS -> PBX -> Integrations -> Applications -> Simple token (for more details, you can check out the documentation: https://wildix.atlassian.net/wiki/x/mBfOAQ).
    To enter the generated authorization token in the Flic app -> HTTP headers section, press Insert and paste the values. Example:

    Key: Authorization Value: Bearer access_K227oU8lrZa8nhOzTMmJL5D7Up0RRwntn8ThGlKr7VrRjKO7adNbe9rsVvuHRRtL
flic-app-settings.png
  1. Press Done to save the changes

Once set up, pressing (or long pressing / double pressing) on the Flic button triggers the alert configured in the Flic app.