Scroll export button | ||||||||
---|---|---|---|---|---|---|---|---|
|
Info |
---|
This guide explains how to configure x-hoppers integration with Veesion, software that allows to detect thefts in real time. Created: January 2023 Updated: April 2024 Permalink: https://wildix.atlassian.net/wiki/x/AQA_Bg Other documentation: x-hoppers User Guide, x-hoppers Admin Guide |
...
Veesion is software that helps to detect thefts in retails retail stores in real time, by analysing video feeds and sending real time alerts when suspicious behaviour is detected.
x-hoppers integration with Veesion is a great way to make your store more secure.
Requirements
- WMS 6
- License requirements:
- x-bees-Standard for clerks
- x-bees-SuperBee for managers
- W-AIR Network components: W-AIR Base stations and repeaters. Amount depends on the store area and the number of users
...
Easy html macro |
---|
<iframe src="https://fast.wistia.com/embed/medias/fwjlhlantt" width="560" height="315" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
|
Configure Veesion integration
Note |
---|
Note: The support starts from WMS Beta 6.02.20221228.1. |
Step 1. Configuration of the webhook
...
- URL of the hook (with PBX as host)
- “storestore_veesion_id” id
Note |
---|
Note: For PBX authorization, the webhook URL should contain the parameter with PBX token /?token=<simple>. The token should be generated for admin only. |
Examples of using Veesion API
...
Code Block |
---|
curl -v --header "Content-Type: application/json" --request POST --data '{"username":"webhook_user@wildix","password":"5SNd#3Ov7h*Ftest"}' https://api.klaxon.veesion.io/token {"token":"1dcbf200cc775968a62a41dad40b8298bd5165a81dcbf200cc455968a66baad40b8238bd5165a8","expires_in":"1702.352942"} |
...
Code Block |
---|
curl -v --header "Authorization: Token 1dcbf200cc775968a62a41dad40b8298bd5165a81dcbf200cc455968a66baad40b8238bd5165a8" --request GET https://api.klaxon.veesion.io/user-info {"user":"webhook_user@wildix","expires_in":"805.326849"} |
...
Code Block |
---|
curl -v --header "Authorization: Token 1dcbf200cc775968a62a41dad40b8298bd5165a81dcbf200cc455968a66baad40b8238bd5165a8" --request GET https://api.klaxon.veesion.io/stores {"stores":[{"store_veesion_id":"test-store-wildix","store_veesion_name":"test store wildix","store_id":""}]} |
...
Code Block |
---|
curl -v --header "Authorization: Token 1dcbf20cc7768a641da40b829bd565a81dcbf200cc455968a66baad40b8238bd5165a8" --header "Content-Type: application/json" --request POST --data '{"store_veesion_id":"test-store-wildix","hooks":["https://semen.wildixin.com/api/v1/veesion?token=access_Wq1WDc79z3Q2Lk6eVlKnaHjuwITfYABBWVPg9MiWrWLJhGKspsWZ2Wq1WDc79z3LL2к6eVlKnaHjuwwEWWERVPg9MiWrWLJhHHspsWZ2"]}' https://api.klaxon.veesion.io/hooks2{"message":"OK"} |
...
- Add a Dialplan rule named veesion
- In the veesion Dialplan, add the following numbers:
- *Alerts", with application Conference and the relevant Room Number:
- veesion, with the following applications:
- Custom application: DumpChan(1) - Custom application: NoOp(store ID: application Play sound, typing text and variables to be played in the conference.
storeId
startDate
endDate
cameraIp
cameraId
groupId
videoUrl
alertType
Example: Attention! Theft detected in ${storeId} camera ID: on ${cameraId}Available variables:
- *Alerts", with application Conference and the relevant Room Number:
Post Veesion alerts to x-bees conversation
Starting from WMS 6.03.20230630.3, it is possible to configure Veesion alerts to be sent to x-bees conversation (you can refer to x-bees documentation for more information about x-bees)
...
Variables available in Dialplan:
...
. The message that is sent to x-bees includes alert type, date, time, camera IP, ID of the camera and group, as well as the relevant video attachment.
Note |
---|
Note: The feature works only if there is an x-hoppers license available on the PBX. |
How to configure
- Add a user in WMS
- Create x-bees conversation with the user created in step 1 and copy the conversation ID (available in the URL)
Add following data to the /rw2/etc/pbx/x-hoppers.json file:
Code Block [ { "store_veesion_id": "test-store-wildix", "name": "Store1", "audio_conf_id": "2", "location": "Odesa", "xbees_channel_id": "f6d17593-98b6-471d-941a-cd03153f", "veesion_user_extension": "12345" } ]
Where:
- store_veesion_id: ID of the store on the Veesion side
- name: name of the store
- audio_conf_id: ID of the audio broadcast channel in x-hoppers where the communication takes place
- location: location of the store
- xbees_channel_id: ID of the x-bees conversation, copied in step 2, where the content will be posted.
- user: user, on behalf of whom the content will be posted
How to modify the alert
Starting from WMS Beta 6.06.20240325.1, it is possible to edit x-hoppers theft alerts: remove camera ID, IP address and group ID, as well as add a message header.
For this, add the following parameters to the /rw2/etc/pbx/x-hoppers.json file:
a) To remove camera IP, camera ID and group ID:
- "remove_camera_ip": true,
- "remove_camera_id": true,
- "remove_group_id": true,
By default, the values are false and camera IP, ID and group ID are displayed in the theft alert.
b) To add message header:
- "xbees_message_header": "header text"
Where "header text" is your custom text for the message header. By default, theft alerts are sent without a header.
Macrosuite divider macro | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...