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 sempre que os dados são enviados por qualquer um dos dispositivos IoT ou Qods que pertencem ao grupo configurado.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte irresso |
| URL | https://desk.zoho.com/portal/skiply |
| ubiqod@skiply.zohodesk.com |
| Metadados do conector | |
|---|---|
| Publicador | Ignorar |
| Site | https://www.ubiqod.com/ |
| Política de privacidade | https://www.skiply.eu/en/privacy-policy-of-ubiqod/ |
| Categorias | Internet das Coisas |
Pré-requisitos
Para continuar, você precisa:
- Um plano do Microsoft Power Apps ou do Power Automate
- Uma assinatura do Ubiqod A Chave de API do Ubiqod pode ser encontrada na seção "Conta" do back-end do Ubiqod.
Preparar 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: verifique se há pelo menos um grupo no back-end do 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 os í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 os í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 de 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 Qod ou do dispositivo IoT
- ID do site: a ID do site à qual o Qod ou o dispositivo IoT está vinculado
- Rótulo do site: nome do site ao qual o Qod ou dispositivo IoT está vinculado
- Email de contato do cliente: email 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 gerenciador de sites: email do gerenciador de sites definido no Site
- Telefone do gerenciador de sites: número de telefone do gerenciador de sites definido no Site
- Valor da ação: rótulo de código ou valor bruto se nenhum código definido na lista de códigos relacionada (índice de botão para dispositivos IoT, se nenhum código definido)
- Condição GPS: 1 se a condição for válida, 0 se não estiver - a condição será válida quando a posição gps do usuário estiver sob a distância de validação da posição do site, 0 se não for ou se o usuário se recusou a fornecer sua posição
- Condição no dispositivo: 1 se a condição for válida, 0 se não estiver – Para dispositivo IoT: a condição é válida quando o selo magnético foi apagado/ Para S-Qod: a condição é válida quando o código QR dinâmico foi verificado do dispositivo e validado pelo servidor Ubiqod
- Condição de código: 1 se a condição for válida, 0 se não estiver – a condição será válida quando o código inserido for definido na lista de códigos relacionada
- Valor gps: se disponível, coordenadas GPS da posição do usuário
- Valor do código de validação: se disponível, rótulo de código de validação ou valor bruto se nenhum código definido na lista de códigos relacionada
- Número de pressionamentos: somente para dispositivos IoT, número de vezes que o botão foi pressionado
- Field_1 personalizado: somente para Qod com um formulário, valor do campo nº 1
- Field_2 personalizado: somente para Qod com um formulário, valor do campo nº 2
- Field_3 personalizado: somente para Qod com um formulário, valor do campo nº 3
- Field_4 personalizado: somente para Qod com um formulário, valor do campo nº 4
Modo normal versus modo de código (somente para dispositivos IoT)
Na configuração do dispositivo IoT, você pode forçar o uso do "modo de código". Se você pressionar o botão 1 e o botão 2, no "modo normal", serão enviadas 2 solicitações separadas (uma 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 em sua lista de códigos).
Testar a conexão
- As contas do Ubiqod incluem dispositivos virtuais que se comportam exatamente da mesma maneira que os dispositivos IoT. Pressione o "botão reproduzir" na lista de dispositivos IoT para iniciar o simulador. Pressione um ou mais botões e aguarde até que as três luzes verdes permaneçam ligadas por um segundo (geralmente 4 segundos após a primeira tecla).
Operações com suporte
O conector dá suporte a apenas uma operação pública:
- DataIn (disparado sempre que um botão envia dados)
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Gatilhos
| Quando os dados são recebidos do dispositivo IoT ou Qod |
Essa operação é disparada 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 é disparada quando um dos dispositivos IoT ou Qods no grupo de destino envia dados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de Grupo
|
group_id | True | integer |
Nome do grupo Ubiqod que você deseja vincular a esse gatilho. |
Retornos
| Nome | 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 Qod ou do dispositivo IoT. |
|
Timestamp
|
request_date | string |
Datetime da verificação de 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ão para dispositivos IoT, se nenhum código definido). |
|
Número de pressionamentos
|
times_button_pressed | integer |
Somente para dispositivos IoT, número de vezes que o botão foi pressionado |
|
Site Id
|
site_id | integer |
ID do site à qual o Qod ou dispositivo IoT está vinculado. |
|
Rótulo do site
|
site_label | string |
Nome do site ao qual o Qod ou dispositivo IoT está vinculado. |
|
Condição no dispositivo
|
badge | integer |
1 se a condição for válida, 0 se não for – Para dispositivo IoT: a condição é válida quando a notificação magnética foi apagada/Para S-Qod: a condição é válida quando o código QR dinâmico foi verificado do dispositivo e validado pelo servidor Ubiqod. |
|
Email de contato do cliente
|
customer_contact_email | string |
Email do contato do cliente definido no Site. |
|
Telefone de contato do cliente
|
customer_contact_phone | string |
Número de telefone do contato do cliente definido no Site. |
|
Email do gerenciador de sites
|
site_manager_email | string |
Email do gerenciador de sites definido no Site. |
|
Telefone do gerenciador de sites
|
site_manager_phone | string |
Número de telefone do gerenciador de sites definido no Site. |
|
Condição gps
|
gps_condition | integer |
1 se a condição for válida, 0 se não estiver - a condição será válida quando a posição gps do usuário estiver sob a distância de validação da posição do site, 0 se não for ou se o usuário se recusou a fornecer sua posição. |
|
Condição de código
|
code_condition | integer |
1 se a condição for válida, 0 se não estiver – a condição será válida quando o código inserido for definido na lista de códigos relacionada. |
|
Valor do 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 nenhum código definido na lista de códigos relacionada. |
|
Campo personalizado 1
|
custom_field_1 | string |
Somente para Qod com um formulário, valor do campo nº 1. |
|
Campo personalizado 2
|
custom_field_2 | string |
Somente para Qod com um formulário, valor do campo nº 2. |
|
Campo personalizado 3
|
custom_field_3 | string |
Somente para Qod com um formulário, valor do campo nº 3. |
|
Campo personalizado 4
|
custom_field_4 | string |
Somente para Qod com um formulário, valor do campo nº 4. |