Ubiqod de Skiply
Ubiqod proporciona una plataforma sencilla y eficaz para conectar los botones de Skiply IoT y Qods a plataformas de terceros. Este conector desencadena un flujo cada vez que cualquiera de los dispositivos IoT o Qod que pertenecen al grupo configurado envían datos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Soporte técnico omito |
| URL | https://desk.zoho.com/portal/skiply |
| Correo Electrónico | ubiqod@skiply.zohodesk.com |
| Metadatos del conector | |
|---|---|
| Publicador | Omitir |
| Sitio web | https://www.ubiqod.com/ |
| Directiva de privacidad | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| Categorías | Internet de las cosas |
Prerrequisitos
Para continuar, necesita lo siguiente:
- Un plan de Microsoft Power Apps o Power Automate
- Una suscripción de Ubiqod La clave de API de Ubiqod se puede encontrar en la sección "Cuenta" del back-end de Ubiqod.
Preparación de los dispositivos IoT y Qod
Antes de usar el desencadenador Ubiqod en Power Automate, preste atención a los siguientes puntos:
- El conector se vinculará a un grupo: asegúrese de que exista al menos un grupo en el back-end de Ubiqod.
- Si un dispositivo IoT o una Qod no está vinculado a una lista de código, se enviará el valor sin procesar del código (o se enviarán índices de botones para dispositivos IoT).
- Si un dispositivo IoT o un Qod están vinculados a una lista de código, pero el código especificado no está definido en la lista de códigos relacionada, se enviará el valor sin procesar del código (o los índices de botones para dispositivos IoT).
Configuración del conector
- Seleccione el desencadenador "When data is received from devices" (Cuando se reciben datos de dispositivos)
- Escriba la clave de API si se solicita.
- En el campo Grupo, seleccione el grupo que contiene los dispositivos IoT o Qod que desea escuchar.
- A continuación, agregue los pasos de su elección.
Campos disponibles
Los siguientes campos están disponibles para la asignación:
- Marca de tiempo: fecha y hora del examen de Qod o transmisión de mensajes de dispositivo IoT
- Identificador: identificador del dispositivo Qod o IoT (s/n)
- Etiqueta Qod o IoT-device: etiqueta del Qod o ioT-device
- Id. de sitio: id. de sitio al que está vinculado Qod o IoT-device
- Etiqueta de sitio: nombre de sitio al que está vinculado el Qod o el dispositivo IoT
- Correo electrónico de contacto del cliente: correo electrónico de contacto de cliente definido en el sitio
- Teléfono de contacto del cliente: número de teléfono de contacto de cliente definido en el sitio
- Correo electrónico del administrador de sitio: correo electrónico del administrador de sitios definido en el sitio
- Teléfono del administrador del sitio: número de teléfono del administrador de sitio definido en el sitio
- Valor de acción: etiqueta de código o valor sin formato si no hay ningún código definido en la lista de códigos relacionada (índice de botón para dispositivos IoT si no se define dicho código).
- Condición GPS: 1 si la condición es válida, 0 si no - condición es válida cuando la posición gps del usuario está bajo la distancia de validación desde la posición del sitio, 0 si no es así o si el usuario se negó a dar su posición
- Condición en el dispositivo: 1 si la condición es válida, 0 si no : para ioT-device: condición es válida cuando se ha deslizado el distintivo magnético / Para S-Qod: condición es válida cuando el código QR dinámico se ha examinado desde el dispositivo y validado por el servidor Ubiqod
- Condición de código: 1 si la condición es válida, 0 si no : la condición es válida cuando el código especificado se define en la lista de códigos relacionada.
- Valor gps: si está disponible, coordenadas GPS de la posición del usuario
- Valor de código de validación: si está disponible, etiqueta de código de validación o valor sin formato si no hay ningún código definido en la lista de códigos relacionada
- Número de presiones: solo para dispositivos IoT, número de veces que se ha presionado el botón
- Field_1 personalizado: solo para Qod con un formulario, el valor del campo n.º 1
- Field_2 personalizado: solo para Qod con un formulario, el valor del campo n.º 2
- Field_3 personalizado: solo para Qod con un formulario, valor del campo n.º 3
- Field_4 personalizado: solo para Qod con un formulario, el valor del campo n.º 4
Modo normal frente al modo de código (solo para dispositivos IoT)
En la configuración del dispositivo IoT, puede forzar el uso de "modo de código". Si presiona el botón 1 y el botón 2, en "modo normal", se envían 2 solicitudes independientes (una para cada botón). En "modo de código", la misma secuencia de presiones solo envía una solicitud, con el código "12" (puede configurar la etiqueta asociada en la lista de códigos).
Pruebe la conexión
- Las cuentas de Ubiqod incluyen dispositivos virtuales que se comportan exactamente del mismo modo que los dispositivos IoT. Presione el "botón reproducir" en la lista de dispositivos IoT para iniciar el simulador. Pulse uno o más botones y espere hasta que las 3 luces verdes permanezcan encendidas durante un segundo (normalmente 4 segundos después de la primera pulsación).
Operaciones admitidas
El conector solo admite una operación pública:
- DataIn (desencadenado cada vez que un botón envía datos)
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API | securestring | Proporcione la clave de API. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Desencadenadores
| Cuando se reciben datos de ioT-device o Qod |
Esta operación se desencadena cuando uno de los dispositivos IoT o Qod del grupo de destino envía datos. |
Cuando se reciben datos de ioT-device o Qod
Esta operación se desencadena cuando uno de los dispositivos IoT o Qod del grupo de destino envía datos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de grupo
|
group_id | True | integer |
Nombre del grupo Ubiqod que desea vincular a este desencadenador. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador
|
device_name | string |
Identificador del Qod o ioT-device (s/n) |
|
Etiqueta Qod o IoT-device
|
device_label | string |
Etiqueta del dispositivo Qod o IoT. |
|
Marca de tiempo
|
request_date | string |
Fecha y hora del examen de Qod o transmisión de mensajes de dispositivo IoT. |
|
Valor de acción
|
button_label | string |
Etiqueta de código o valor sin formato si no hay ningún código definido en la lista de códigos relacionada (índice de botón para dispositivos IoT si no se define dicho código). |
|
Número de presiones
|
times_button_pressed | integer |
Solo para dispositivos IoT, número de veces que se ha presionado el botón |
|
Id. de sitio
|
site_id | integer |
Id. de sitio al que está vinculado Qod o IoT-device. |
|
Etiqueta de sitio
|
site_label | string |
Nombre de sitio al que está vinculado Qod o IoT-device. |
|
Condición en el dispositivo
|
badge | integer |
1 si la condición es válida, 0 si no - Para ioT-device: condición es válida cuando se ha deslizado el distintivo magnético / Para S-Qod: condición es válida cuando el código QR dinámico se ha examinado desde el dispositivo y validado por el servidor Ubiqod. |
|
Correo electrónico de contacto del cliente
|
customer_contact_email | string |
Correo electrónico del contacto del cliente definido en el sitio. |
|
Teléfono de contacto del cliente
|
customer_contact_phone | string |
Número de teléfono de contacto de cliente definido en el sitio. |
|
Correo electrónico del administrador de sitios
|
site_manager_email | string |
Correo electrónico del administrador de sitios definido en el sitio. |
|
Teléfono del administrador del sitio
|
site_manager_phone | string |
Número de teléfono del administrador de sitio definido en el sitio. |
|
Condición de GPS
|
gps_condition | integer |
1 si la condición es válida, 0 si no - condición es válida cuando la posición gps del usuario está bajo la distancia de validación desde la posición del sitio, 0 si no es así o si el usuario se negó a dar su posición. |
|
Condición de código
|
code_condition | integer |
1 si la condición es válida, 0 si no - condición es válida cuando el código especificado se define en la lista de códigos relacionada. |
|
Valor gps
|
gps_value | string |
Si está disponible, coordenadas GPS de la posición del usuario. |
|
Valor de código de validación
|
validation_code_value | string |
Si está disponible, la etiqueta de código de validación o el valor sin formato si no hay ningún código definido en la lista de códigos relacionada. |
|
Campo personalizado 1
|
custom_field_1 | string |
Solo para Qod con un formulario, valor del campo n.º 1. |
|
Campo personalizado 2
|
custom_field_2 | string |
Solo para Qod con un formulario, valor del campo n.º 2. |
|
Campo personalizado 3
|
custom_field_3 | string |
Solo para Qod con un formulario, valor del campo n.º 3. |
|
Campo personalizado 4
|
custom_field_4 | string |
Solo para Qod con un formulario, valor del campo n.º 4. |