Ubiqod by Skiply
Ubiqod provides a simple and powerful platform to connect your Skiply IoT buttons and Qods to third party platforms. This connector triggers a flow every time data is sent by any of the IoT-devices or Qods belonging to the configured group.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Skiply Support |
| URL | https://desk.zoho.com/portal/skiply |
| [email protected] |
| Connector Metadata | |
|---|---|
| Publisher | Skiply |
| Website | https://www.ubiqod.com/ |
| Privacy policy | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| Categories | Internet of Things |
Prerequisites
To proceed, you need:
- A Microsoft Power Apps or Power Automate plan
- A Ubiqod subscription The Ubiqod API Key can be found in the "Account" section of your Ubiqod backend.
Prepare your IoT-devices and Qods
Before using the Ubiqod trigger in Power Automate, pay attention to the following points:
- The connector will be linked to a group: make sure at least one group exists in your Ubiqod backend.
- If an IoT-device or a Qod is not linked to a Code list, the raw value of the code will be sent (or buttons indexes for IoT-devices).
- If an IoT-device or a Qod is linked to a Code list but the entered code is not defined in the related Code list, the raw value of the code will be sent (or buttons indexes for IoT-devices).
Set up the connector
- Select the trigger "When data is received from devices"
- Enter your API Key if requested
- From the Group field, select the Group containing the IoT-devices and/or Qods you want to listen to
- Then add the steps of your choice
Available fields
The following fields are available for mapping:
- Timestamp: datetime of Qod scanning or IoT-device message transmission
- Identifier: identifier of the Qod or IoT-device (s/n)
- Qod or IoT-device label: label of the Qod or IoT-device
- Site ID: site ID the Qod or IoT-device is linked to
- Site label: site name the Qod or IoT-device is linked to
- Customer contact email: email of customer contact defined on Site
- Customer contact phone: phone number of customer contact defined on Site
- Site manager email: email of site manager defined on Site
- Site manager phone: phone number of site manager defined on Site
- Action value: code label or raw value if no such code defined in the related code list (button index for IoT-devices if no such code defined)
- GPS condition: 1 if condition is valid, 0 if not - condition is valid when the user GPS position is under the validation distance from the site position, 0 if not or if the user refused to give its position
- On-device condition: 1 if condition is valid, 0 if not - For IoT-device: condition is valid when magnetic badge has been swiped / For S-Qod: condition is valid when dynamic QR code has been scanned from the device and validated by the Ubiqod server
- Code condition: 1 if condition is valid, 0 if not - condition is valid when the entered code is defined in the related code list
- GPS value: if available, GPS coordinates of the user's position
- Validation code value: if available, validation code label or raw value if no such code defined in the related code list
- Number of presses: only for IoT-devices, number of times the button was pressed
- Custom field_1: only for Qod with a form, value of field #1
- Custom field_2: only for Qod with a form, value of field #2
- Custom field_3: only for Qod with a form, value of field #3
- Custom field_4: only for Qod with a form, value of field #4
Normal mode vs code mode (only for IoT-devices)
In the configuration of your IoT-device, you can force the use of “code mode”. If you press button 1 and button 2, in “normal mode”, 2 separate requests are sent (one for each button). In “code mode”, the same sequence of presses only sends one request, with code "12" (you can configure the associated label in your Code list).
Test the connection
- Ubiqod accounts include virtual devices which behave exactly the same way as IoT-devices. Press the "play button" in the IoT-device list to launch the simulator. Press one or more buttons, and wait until the 3 green lights stay on for one second (usually 4 seconds after the first press).
Supported Operations
The connector supports only one public operation:
- DataIn (triggered every time a button sends data)
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | Provide your API Key. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Triggers
| When data is received from IoT-device or Qod |
This operation triggers when one of the IoT-devices or Qods in the target group sends data. |
When data is received from IoT-device or Qod
This operation triggers when one of the IoT-devices or Qods in the target group sends data.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Group Name
|
group_id | True | integer |
Name of the Ubiqod group you want to link to this trigger. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Identifier
|
device_name | string |
Identifier of the Qod or IoT-device (s/n) |
|
Qod or IoT-device label
|
device_label | string |
Label of the Qod or IoT-device. |
|
Timestamp
|
request_date | string |
Datetime of Qod scanning or IoT-device message transmission. |
|
Action value
|
button_label | string |
Code label or raw value if no such code defined in the related code list (button index for IoT-devices if no such code defined). |
|
Number of presses
|
times_button_pressed | integer |
Only for IoT-devices, number of times the button was pressed |
|
Site Id
|
site_id | integer |
Site ID the Qod or IoT-device is linked to. |
|
Site label
|
site_label | string |
Site name the Qod or IoT-device is linked to. |
|
On-device condition
|
badge | integer |
1 if condition is valid, 0 if not - For IoT-device: condition is valid when magnetic badge has been swiped / For S-Qod: condition is valid when dynamic QR code has been scanned from the device and validated by the Ubiqod server. |
|
Customer contact email
|
customer_contact_email | string |
Email of customer contact defined on Site. |
|
Customer contact phone
|
customer_contact_phone | string |
Phone number of customer contact defined on Site. |
|
Site manager email
|
site_manager_email | string |
Email of site manager defined on Site. |
|
Site manager phone
|
site_manager_phone | string |
Phone number of site manager defined on Site. |
|
GPS condition
|
gps_condition | integer |
1 if condition is valid, 0 if not - condition is valid when the user GPS position is under the validation distance from the site position, 0 if not or if the user refused to give its position. |
|
Code condition
|
code_condition | integer |
1 if condition is valid, 0 if not - condition is valid when the entered code is defined in the related code list. |
|
GPS value
|
gps_value | string |
If available, GPS coordinates of the user's position. |
|
Validation code value
|
validation_code_value | string |
If available, validation code label or raw value if no such code defined in the related code list. |
|
Custom field 1
|
custom_field_1 | string |
Only for Qod with a form, value of field #1. |
|
Custom field 2
|
custom_field_2 | string |
Only for Qod with a form, value of field #2. |
|
Custom field 3
|
custom_field_3 | string |
Only for Qod with a form, value of field #3. |
|
Custom field 4
|
custom_field_4 | string |
Only for Qod with a form, value of field #4. |