Compartir a través de


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.