Ubiqod por Skiply
O Ubiqod fornece uma plataforma simples e poderosa para conectar seus botões Skiply IoT e Qods a plataformas de terceiros. Esse conector dispara um fluxo toda vez que os dados são enviados por qualquer um dos dispositivos IoT ou Qods pertencentes ao grupo configurado.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte Skiply |
| URL | https://desk.zoho.com/portal/skiply |
| ubiqod@skiply.zohodesk.com |
| Metadados do conector | |
|---|---|
| Editora | Pular |
| Sítio Web | https://www.ubiqod.com/ |
| Política de privacidade | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| Categorias | Internet das Coisas |
Pré-requisitos
Para prosseguir, você precisa:
- Um plano Microsoft Power Apps ou Power Automate
- Uma assinatura do Ubiqod A chave da API do Ubiqod pode ser encontrada na seção "Conta" do seu back-end do Ubiqod.
Prepare seus dispositivos IoT e Qods
Antes de usar o gatilho Ubiqod no Power Automate, preste atenção aos seguintes pontos:
- O conector será vinculado a um grupo: certifique-se de que pelo menos um grupo existe no seu back-end Ubiqod.
- Se um dispositivo IoT ou um Qod não estiver vinculado a uma lista de códigos, o valor bruto do código será enviado (ou índices de botões para dispositivos IoT).
- Se um dispositivo IoT ou um Qod estiver vinculado a uma lista de códigos, mas o código inserido não estiver definido na lista de códigos relacionada, o valor bruto do código será enviado (ou índices de botões para dispositivos IoT).
Configurar o conector
- Selecione o gatilho "Quando os dados são recebidos de dispositivos"
- Insira sua chave de API, se solicitado
- No campo Grupo, selecione o Grupo que contém os dispositivos IoT e/ou Qods que você deseja ouvir
- Em seguida, adicione as etapas de sua escolha
Campos disponíveis
Os seguintes campos estão disponíveis para mapeamento:
- Carimbo de data/hora: datetime da verificação Qod ou transmissão de mensagens do dispositivo IoT
- Identificador: identificador do dispositivo Qod ou IoT (s/n)
- Rótulo do dispositivo Qod ou IoT: rótulo do dispositivo Qod ou IoT
- ID do site: ID do site ao qual o Qod ou o dispositivo IoT está vinculado
- Rótulo do site: nome do site ao qual o Qod ou o dispositivo IoT está vinculado
- Email de contato do cliente: e-mail do contato do cliente definido no Site
- Telefone de contato do cliente: número de telefone do contato do cliente definido no Site
- Email do gerente do site: e-mail do gerente do site definido no site
- Telefone do gestor do site: número de telefone do gestor do site definido no Site
- Valor da ação: rótulo de código ou valor bruto, se nenhum código estiver definido na lista de códigos relacionada (índice de botões para dispositivos IoT, se nenhum código estiver definido)
- Condição GPS: 1 se a condição é válida, 0 se não - condição é válida quando a posição GPS do usuário está abaixo da distância de validação da posição do site, 0 se não ou se o usuário se recusou a dar sua posição
- Condição no dispositivo: 1 se a condição for válida, 0 se não - Para dispositivo IoT: condição é válida quando o crachá magnético foi passado / Para S-Qod: condição é válida quando o código QR dinâmico foi digitalizado a partir do dispositivo e validado pelo servidor Ubiqod
- Condição do código: 1 se a condição for válida, 0 se não - a condição é válida quando o código inserido é definido na lista de códigos relacionada
- Valor GPS: se disponível, coordenadas GPS da posição do utilizador
- Valor do código de validação: se disponível, rótulo do código de validação ou valor bruto, se tal código não estiver definido na lista de códigos relacionada
- Número de pressionamentos: apenas para dispositivos IoT, número de vezes que o botão foi pressionado
- field_1 personalizado: apenas para Qod com um formulário, valor do campo #1
- field_2 personalizado: apenas para Qod com um formulário, valor do campo #2
- field_3 personalizado: apenas para Qod com um formulário, valor do campo #3
- field_4 personalizado: apenas para Qod com um formulário, valor do campo #4
Modo normal vs modo de código (apenas para dispositivos IoT)
Na configuração do seu dispositivo IoT, você pode forçar o uso do "modo de código". Se premir o botão 1 e o botão 2, no "modo normal", são enviados 2 pedidos separados (um para cada botão). No "modo de código", a mesma sequência de pressionamentos envia apenas uma solicitação, com o código "12" (você pode configurar o rótulo associado na sua lista de códigos).
Testar a ligação
- As contas Ubiqod incluem dispositivos virtuais que se comportam exatamente da mesma maneira que os dispositivos IoT. Pressione o botão "play" na lista de dispositivos IoT para iniciar o simulador. Pressione um ou mais botões e aguarde até que as 3 luzes verdes permaneçam acesas por um segundo (geralmente 4 segundos após a primeira pressão).
Operações suportadas
O conector suporta apenas uma operação pública:
- DataIn (acionado sempre que um botão envia dados)
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | securestring | Forneça sua chave de API. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Acionadores
| Quando os dados são recebidos do dispositivo IoT ou Qod |
Essa operação é acionada quando um dos dispositivos IoT ou Qods no grupo de destino envia dados. |
Quando os dados são recebidos do dispositivo IoT ou Qod
Essa operação é acionada quando um dos dispositivos IoT ou Qods no grupo de destino envia dados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Grupo
|
group_id | True | integer |
Nome do grupo Ubiqod que você deseja vincular a esse gatilho. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificador
|
device_name | string |
Identificador do dispositivo Qod ou IoT (s/n) |
|
Rótulo de dispositivo Qod ou IoT
|
device_label | string |
Rótulo do dispositivo Qod ou IoT. |
|
Data e Hora
|
request_date | string |
Data/hora da verificação Qod ou transmissão de mensagens do dispositivo IoT. |
|
Valor da ação
|
button_label | string |
Rótulo de código ou valor bruto se nenhum código definido na lista de códigos relacionada (índice de botões para dispositivos IoT, se nenhum código definido por isso). |
|
Número de prensas
|
times_button_pressed | integer |
Apenas para dispositivos IoT, número de vezes que o botão foi pressionado |
|
Site Id
|
site_id | integer |
ID do site ao qual o Qod ou o dispositivo IoT está vinculado. |
|
Rótulo do site
|
site_label | string |
Nome do site ao qual o Qod ou o dispositivo IoT está vinculado. |
|
Condição no dispositivo
|
badge | integer |
1 se a condição for válida, 0 se não - Para dispositivo IoT: a condição é válida quando o crachá magnético foi passado / Para S-Qod: a condição é válida quando o código QR dinâmico foi digitalizado a partir do dispositivo e validado pelo servidor Ubiqod. |
|
E-mail de contato do cliente
|
customer_contact_email | string |
Email de contato do cliente definido no Site. |
|
Telefone de contacto do cliente
|
customer_contact_phone | string |
Número de telefone do contato do cliente definido no Site. |
|
E-mail do gestor do site
|
site_manager_email | string |
Email do gestor do site definido no Site. |
|
Telefone do gestor do site
|
site_manager_phone | string |
Número de telefone do gestor do site definido no Site. |
|
Condição GPS
|
gps_condition | integer |
1 se a condição for válida, 0 se não - a condição é válida quando a posição GPS do usuário está abaixo da distância de validação da posição do site, 0 se não ou se o usuário se recusou a dar sua posição. |
|
Condição do código
|
code_condition | integer |
1 se a condição for válida, 0 se não - a condição é válida quando o código inserido é definido na lista de códigos relacionada. |
|
Valor GPS
|
gps_value | string |
Se disponível, coordenadas GPS da posição do usuário. |
|
Valor do código de validação
|
validation_code_value | string |
Se disponível, rótulo de código de validação ou valor bruto, se tal código não estiver definido na lista de códigos relacionada. |
|
Campo personalizado 1
|
custom_field_1 | string |
Apenas para Qod com um formulário, valor do campo #1. |
|
Campo personalizado 2
|
custom_field_2 | string |
Apenas para Qod com um formulário, valor do campo #2. |
|
Campo personalizado 3
|
custom_field_3 | string |
Apenas para Qod com um formulário, valor do campo #3. |
|
Campo personalizado 4
|
custom_field_4 | string |
Apenas para Qod com um formulário, valor do campo #4. |