Derdack SIGNL4
O Derdack SIGNL4 é um aplicativo de notificação móvel para notificar de forma confiável as equipes de operações de plantão e aumentar sua produtividade.
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 | |
|---|---|
| URL | https://www.signl4.com/feedback-we-love-hear-from-you/ |
| info@signl4.com |
| Metadados do conector | |
|---|---|
| Publicador | Derdack GmbH |
| Website | https://www.signl4.com |
| Política de privacidade | https://www.signl4.com/privacy-policy/ |
O conector SIGNL4 permite que você
- Enviar notificações de alertas móveis persistentes com escalonamentos automatizados
- Acompanhar entrega e confirmações
- Rotear alertas para as pessoas certas considerando a disponibilidade oportuna dos membros da equipe (por exemplo, serviço de plantão, turnos)
- Obter transparência sobre a propriedade e a resposta do alerta
Use o conector SIGNL4 para enviar alertas em qualquer gatilho ou em qualquer terceiro sistema. Ele também permite que você estenda casos de usos SIGNL4 existentes. Por exemplo, você pode socar um usuário dentro ou fora de serviço com base em calendários no Microsoft Office 365, Microsoft StaffHub, Google Calendars e muito mais. Outro cenário é a extração de métricas de desempenho de deslocamento (por exemplo, resposta de alerta, em horários de serviço) de SIGNL4 para uma trilha de auditoria personalizada, como um arquivo csv simples, regularmente.
Ao criar uma conexão com o SIGNL4, basta fazer logon com suas credenciais de usuário SIGNL4 (ou qualquer outra conta com suporte, como sua conta corporativa ou de estudante da Microsoft) e dar seu consentimento sobre as permissões solicitadas. Posteriormente, você poderá invocar todas as ações da API no escopo da equipe SIGNL4. Isso significa que você pode, por exemplo, socar outras pessoas em sua equipe para o serviço de plantão, mas ninguém de outras equipes SIGNL4.
Mais informações sobre o produto e a API são encontradas online em https://www.signl4.com/.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Alerta de gatilho |
Dispara um novo alerta para sua equipe. Todos os membros da equipe de plantão receberão notificações de alerta. |
| Confirmar tudo |
Esse método confirma todos os alertas sem tratamento que sua equipe tem no momento. |
| Obter relatório de alerta |
Retorna informações sobre o volume de alerta ocorrido em períodos de tempo diferentes, bem como informações sobre o comportamento da resposta (quantidade de alertas confirmados e sem tratamento) dos membros da equipe. |
| Obter todos os usuários |
Retorna uma lista de objetos de usuário com detalhes, como seu endereço de email. Somente os usuários que fazem parte da sua equipe serão retornados. |
| Obter usuário por ID |
Retorna os detalhes de um usuário, como nome, endereço de email etc. |
| Socar o usuário |
Usando essa operação, o usuário especificado será levado ao serviço. |
| Socar o usuário para fora |
Usando essa operação, o usuário especificado será retirado do serviço. |
Alerta de gatilho
Dispara um novo alerta para sua equipe. Todos os membros da equipe de plantão receberão notificações de alerta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID externa
|
externalId | string |
Uma ID exclusiva em seu sistema para referenciar esse alerta. Você pode usar esse campo para corresponder aos alertas disparados com essa ID, por exemplo, ao consultar um status atualizado do alerta posteriormente. |
|
|
Categoria de alerta
|
category | string |
Nome de uma categoria de sistema ou dispositivo em sua equipe SIGNL4 à qual esse alerta deve pertencer. |
|
|
ID exclusiva desse anexo em SIGNL4
|
id | string |
ID exclusiva desse anexo em SIGNL4. |
|
|
Codificação de anexo
|
encoding | integer |
Indica se o conteúdo é codificado em Base64 (1) ou não (0). |
|
|
Nome do anexo
|
name | True | string |
Nome desse anexo, por exemplo, um nome de arquivo de imagem original. |
|
Tipo MIME de anexo
|
contentType | True | string |
Tipo de conteúdo MIME desse anexo, como image/jpg (com codificação 1) ou texto/simples (por exemplo, com codificação 0). |
|
Dados de anexo
|
content | True | string |
Dados desse anexo, como uma cadeia de caracteres Base64 que representa uma imagem jpg. |
|
Nome do parâmetro
|
name | True | string |
Nome desse parâmetro, por exemplo, temperatura. |
|
Tipo de parâmetro
|
type | integer |
Tipo desse parâmetro. Esse campo é reservado para uso posterior e sempre deve corresponder a 0 ao defini-lo. |
|
|
Valor do parâmetro
|
value | True | string |
O valor do parâmetro, por exemplo, 56F. |
|
Título do alerta
|
title | True | string |
Título ou assunto deste alerta, por exemplo, "Alerta de temperatura". |
|
Detalhes do Alerta
|
text | True | string |
Detalhes do alerta textual, por exemplo, "A temperatura diminuiu 10F nos últimos 4 minutos". |
Retornos
- Corpo
- AlertInfo
Confirmar tudo
Esse método confirma todos os alertas sem tratamento que sua equipe tem no momento.
Obter relatório de alerta
Retorna informações sobre o volume de alerta ocorrido em períodos de tempo diferentes, bem como informações sobre o comportamento da resposta (quantidade de alertas confirmados e sem tratamento) dos membros da equipe.
Retornos
Um objeto que contém informações sobre o volume de alerta ocorrido em diferentes períodos de tempo, bem como informações sobre o comportamento da resposta (quantidade de alertas confirmados e sem tratamento) dos membros da equipe.
- Um objeto que contém informações sobre o volume de alerta ocorrido em períodos de tempo diferentes
- AlertReport
Obter todos os usuários
Retorna uma lista de objetos de usuário com detalhes, como seu endereço de email. Somente os usuários que fazem parte da sua equipe serão retornados.
Retornos
- Itens
- GetAllUsers_Response
Obter usuário por ID
Retorna os detalhes de um usuário, como nome, endereço de email etc.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificação de usuário
|
userId | True | string |
Identificador do usuário a ser obtido. Use 'Me' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de email de um usuário na equipe ou a ID exclusiva de um objeto de usuário de acordo. |
Retornos
Informações básicas sobre um usuário.
- Corpo
- UserInfo
Socar o usuário
Usando essa operação, o usuário especificado será levado ao serviço.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificação de usuário
|
userId | True | string |
Identificador do usuário a ser socado. Use 'Me' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de email de um usuário na equipe ou a ID exclusiva de um objeto de usuário de acordo. |
Retornos
Informações sobre o status de dever de um usuário.
- Corpo
- UserDutyInfo
Socar o usuário para fora
Usando essa operação, o usuário especificado será retirado do serviço.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Identificação de usuário
|
userId | True | string |
Identificador do usuário a ser socado. Use 'Me' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de email de um usuário na equipe ou a ID exclusiva de um objeto de usuário de acordo. |
Retornos
Informações sobre o status de dever de um usuário.
- Corpo
- UserDutyInfo
Definições
Informações do usuário
Informações básicas sobre um usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificação de usuário
|
id | string |
ID do utilizador. |
|
Email
|
string |
O endereço de email do usuário. |
|
|
Nome
|
name | string |
Nome do usuário. |
|
ID da assinatura
|
subscriptionId | string |
ID da assinatura à qual o usuário pertence. |
AlertInfo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do alerta
|
id | string |
ID exclusiva do alerta em SIGNL4. |
|
ID externa
|
externalId | string |
Uma ID exclusiva em seu sistema para referenciar esse alerta. Você pode usar esse campo para corresponder aos alertas disparados com essa ID, por exemplo, ao consultar um status atualizado do alerta posteriormente. |
|
ID da assinatura
|
subscriptionId | string |
ID exclusiva da sua assinatura SIGNL4. |
|
ID da equipe
|
teamId | string |
ID exclusiva da sua equipe SIGNL4. |
|
ID da categoria
|
categoryId | string |
ID exclusiva de uma categoria de sistema ou dispositivo em sua equipe SIGNL4 à qual esse alerta pertence. |
|
Categoria de sistema ou dispositivo
|
category | string |
Nome de uma categoria de sistema ou dispositivo em sua equipe SIGNL4 à qual esse alerta pertence. |
|
Severidade do alerta
|
severity | integer |
Gravidade desse alerta em SIGNL4. Esse campo é reservado para uso posterior. |
|
ID exclusiva da API ou da origem por meio da qual esse alerta foi disparado para sua equipe SIGNL4
|
eventSourceId | string |
ID exclusiva da API ou da origem por meio da qual esse alerta foi disparado para sua equipe SIGNL4. |
|
Tipo da API ou da origem por meio da qual esse alerta foi disparado para sua equipe SIGNL4
|
eventSourceType | integer |
Tipo da API ou origem por meio da qual esse alerta foi disparado para sua equipe SIGNL4. |
|
Hora em que esse alerta foi modificado pela última vez em SIGNL4
|
lastModified | date-time |
Hora em que esse alerta foi modificado pela última vez em SIGNL4. |
|
Coleção de conjuntos de anexos, como imagens que pertencem a este alerta
|
attachments | array of object |
Coleção de conjuntos de anexos, como imagens que pertencem a esse alerta. |
|
ID exclusiva desses anexos em SIGNL4
|
attachments.id | string |
ID exclusiva desses anexos em SIGNL4. |
|
Indica se o conteúdo é Base64 ou codificado (1) ou não (0)
|
attachments.encoding | integer |
Indica se o conteúdo é Base64 ou codificado (1) ou não (0). |
|
Nome do anexo
|
attachments.name | string |
Nome desse anexo, por exemplo, um nome de arquivo de imagem original. |
|
Tipo de conteúdo MIME
|
attachments.contentType | string |
Tipo de conteúdo MIME desse anexo, como image/jpg. |
|
Conteúdo do anexo
|
attachments.content | string |
O conteúdo desse anexo. |
|
Uma coleção de anotações que os usuários deixaram neste alerta
|
annotations | array of object |
Uma coleção de anotações que os usuários deixaram neste alerta. |
|
Tipo de anotação
|
annotations.type | integer |
Tipo dessa anotação. Esse campo é reservado para uso posterior. |
|
Anotação do usuário
|
annotations.text | string |
A anotação deixada por um usuário. |
|
ID exclusiva do usuário SIGNL4 que deixou a anotação
|
annotations.userId | string |
ID exclusiva do usuário SIGNL4 que deixou a anotação. |
|
Uma coleção de pares chave/valor com parâmetros adicionais de dispositivo ou sistema que pertencem a esse alerta
|
parameters | array of object |
Uma coleção de pares chave/valor com parâmetros adicionais de dispositivo ou sistema que pertencem a esse alerta. |
|
Nome do parâmetro
|
parameters.name | string |
Nome desse parâmetro, por exemplo, temperatura. |
|
Tipo de parâmetro
|
parameters.type | integer |
Tipo desse parâmetro. Esse campo é reservado para uso posterior e sempre deve corresponder a 0 ao defini-lo. |
|
Valor do parâmetro
|
parameters.value | string |
O valor do parâmetro, por exemplo, 56F. |
|
Hora em que este alerta foi confirmado
|
history.acknowledged | date-time |
Hora em que esse alerta foi confirmado. |
|
Nome do membro da equipe que confirmou o alerta
|
history.acknowledgedBy | string |
Nome do membro da equipe que confirmou o alerta. |
|
Hora em que esse alerta foi fechado
|
history.closed | date-time |
Hora em que esse alerta foi fechado. |
|
Nome do membro da equipe que fechou o alerta
|
history.closedBy | string |
Nome do membro da equipe que fechou o alerta. |
|
Hora em que esse alerta foi criado em SIGNL4
|
history.created | date-time |
Hora em que esse alerta foi criado em SIGNL4. |
|
Status do alerta
|
status | integer |
Status do alerta em SIGNL4. 1 representa um alerta sem tratamento, enquanto 2 representa um alerta confirmado. Todos os outros valores são reservados para uso posterior e nunca devem ser um valor de uma instância desse objeto. |
|
Alterar título
|
title | string |
Título ou assunto deste alerta. |
|
Detalhes do alerta textual
|
text | string |
Detalhes do alerta textual. |
AlertReport
Um objeto que contém informações sobre o volume de alerta ocorrido em diferentes períodos de tempo, bem como informações sobre o comportamento da resposta (quantidade de alertas confirmados e sem tratamento) dos membros da equipe.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Quantidade de alertas que ocorreram nas últimas 24h e sua equipe confirmou dentro desse tempo
|
last24Hours.acknowledged | integer |
Quantidade de alertas que ocorreram nas últimas 24h e sua equipe confirmou dentro desse tempo. |
|
Hora em que esse período de tempo terminou ou terminará
|
last24Hours.end | date-time |
Hora em que esse período de tempo terminou ou terminará. |
|
Última vez que essa métrica foi alterada
|
last24Hours.lastModified | date-time |
Última vez que essa métrica foi alterada. |
|
Hora em que esse período de tempo foi iniciado ou será iniciado
|
last24Hours.start | date-time |
Hora em que esse período de tempo foi iniciado ou será iniciado. |
|
Quantidade de alertas que ocorreram nas últimas 24h e sua equipe não confirmou dentro desse tempo
|
last24Hours.unhandled | integer |
A quantidade de alertas que ocorreram nas últimas 24h e sua equipe não foi confirmada nesse período. |
|
ID exclusiva de sua assinatura SIGNL4
|
subscriptionId | string |
ID exclusiva da sua assinatura SIGNL4. |
|
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe confirmou dentro desse período
|
teamCurrentDuty.acknowledged | integer |
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe confirmou dentro desse período. |
|
Hora em que esse período de serviço terminou ou terminará
|
teamCurrentDuty.end | date-time |
Hora em que esse período de serviço terminou ou terminará. |
|
Última vez que essa métrica foi alterada
|
teamCurrentDuty.lastModified | date-time |
Última vez que essa métrica foi alterada. |
|
Hora em que esse período de serviço foi iniciado ou será iniciado
|
teamCurrentDuty.start | date-time |
Hora em que esse período de serviço foi iniciado ou será iniciado. |
|
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe não confirmou dentro desse período
|
teamCurrentDuty.unhandled | integer |
A quantidade de alertas que ocorreram no período de serviço atual e sua equipe não foi confirmada nesse período. |
|
ID exclusiva da equipe SIGNL4 para a qual este relatório de alerta foi criado/solicitado. Estará vazio se sua equipe tiver desligado o assistente de serviço SIGNL4
|
teamId | string |
ID exclusiva da equipe SIGNL4 para a qual este relatório de alerta foi criado/solicitado. Ficará vazio se sua equipe tiver desligado o assistente de serviço SIGNL4. |
|
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe confirmou dentro desse período
|
teamLastDuty.acknowledged | integer |
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe confirmou dentro desse período. |
|
Hora em que esse período de serviço terminou ou terminará
|
teamLastDuty.end | date-time |
Hora em que esse período de serviço terminou ou terminará. |
|
Última vez que essa métrica foi alterada
|
teamLastDuty.lastModified | date-time |
Última vez que essa métrica foi alterada. |
|
Hora em que esse período de serviço foi iniciado ou será iniciado
|
teamLastDuty.start | date-time |
Hora em que esse período de serviço foi iniciado ou será iniciado. |
|
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe não confirmou dentro desse período
|
teamLastDuty.unhandled | integer |
A quantidade de alertas que ocorreram no período de serviço anterior e sua equipe não foi confirmada nesse período. |
|
ID exclusiva do usuário SIGNL4 para o qual este relatório de alerta foi criado/solicitado. Estará vazio se sua equipe tiver ligado o assistente de serviço SIGNL4
|
userId | string |
ID exclusiva do usuário SIGNL4 para o qual este relatório de alerta foi criado/solicitado. Estará vazio se sua equipe tiver ligado o assistente de serviço SIGNL4. |
|
Quantidade de alertas que ocorreram desde que o status do dever dos usuários foi alterado da última vez e ela confirmou dentro desse período
|
userLastDutyChange.acknowledged | integer |
Quantidade de alertas que ocorreram desde que o status do dever dos usuários foi alterado da última vez e ela confirmou dentro desse período. |
|
Hora em que esse período terminou ou terminará
|
userLastDutyChange.end | date-time |
Hora em que esse período terminou ou terminará. |
|
últimaModificação
|
userLastDutyChange.lastModified | date-time | |
|
Hora em que esse período foi iniciado ou será iniciado
|
userLastDutyChange.start | date-time |
Hora em que esse período foi iniciado ou será iniciado. |
|
Quantidade de alertas que ocorreram desde que o status do dever dos usuários foi alterado da última vez e ela não confirmou dentro desse período
|
userLastDutyChange.unhandled | integer |
Quantidade de alertas que ocorreram desde que o status do dever dos usuários foi alterado da última vez e ela não confirmou dentro desse período. |
UserDutyInfo
Informações sobre o status de dever de um usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Socar Date-Time
|
lastChange | date-time |
A data e hora no formato UTC. ex. yyyyy-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Em serviço
|
onDuty | boolean |
True se o usuário estiver de plantão. |
|
Atrasado
|
overdue | boolean |
True se o usuário estiver atualmente atrasado, por exemplo, porque ninguém mais substituiu esse usuário a tempo. |
GetAllUsers_Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
UserInfo |
Informações básicas sobre um usuário. |