Derdack SIGNL4
O Derdack SIGNL4 é um aplicativo de notificação móvel para notificar de forma confiável as equipes de operações em serviço e aumentar sua produtividade.
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 | |
|---|---|
| URL | https://www.signl4.com/feedback-we-love-hear-from-you/ |
| info@signl4.com |
| Metadados do conector | |
|---|---|
| Editora | Derdack GmbH |
| Sítio Web | https://www.signl4.com |
| Política de privacidade | https://www.signl4.com/privacy-policy/ |
O conector SIGNL4 permite-lhe:
- Envie notificações de alertas móveis persistentes com escalonamentos automatizados
- Acompanhe a entrega e confirmações
- Encaminhe alertas para as pessoas certas, considerando a disponibilidade oportuna dos membros da equipe (por exemplo, plantão de plantão, turnos)
- Ganhe transparência sobre a propriedade e a resposta ao alerta
Use o conector SIGNL4 para enviar alertas em qualquer gatilho ou de qualquer 3º sistema. Ele também permite que você estenda os casos de uso existentes do SIGNL4. Por exemplo, você pode inserir ou sair de um usuário 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 turno (por exemplo, resposta de alerta, tempos de serviço) do SIGNL4 para uma trilha de auditoria personalizada, como um arquivo csv simples, regularmente.
Quando cria uma ligação ao SIGNL4, basta iniciar sessão com as suas credenciais de utilizador do SIGNL4 (ou qualquer outra conta suportada, como a sua conta escolar ou profissional da Microsoft) e dar o seu consentimento sobre as permissões solicitadas. Posteriormente, você poderá invocar todas as ações da API no escopo da sua equipe SIGNL4. Isso significa que você pode, por exemplo, dar um soco em outras pessoas da 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 podem ser encontradas on-line em https://www.signl4.com/.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Alerta de gatilho |
Aciona um novo alerta para sua equipe. Todos os membros da equipa de serviço receberão notificações de alerta. |
| Confirmar tudo |
Esse método confirma todos os alertas não tratados que sua equipe tem atualmente. |
| Obter relatório de alerta |
Retorna informações sobre o volume de alertas ocorridos em diferentes períodos de tempo, bem como informações sobre o comportamento de resposta (quantidade de alertas confirmados e não tratados) dos membros da sua equipe. |
| Obter todos os usuários |
Retorna uma lista de objetos de usuário com detalhes como seu endereço de e-mail. 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 e-mail, etc. |
| Punch usuário em |
Usando esta operação, o usuário especificado será perfurado para o dever. |
| Punch usuário para fora |
Usando esta operação, o usuário especificado será perfurado fora de serviço. |
Alerta de gatilho
Aciona um novo alerta para sua equipe. Todos os membros da equipa de serviço receberão notificações de alerta.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Identificação externa
|
externalId | string |
Um ID exclusivo no seu sistema para referenciar este alerta. Pode utilizar este campo para fazer corresponder os alertas que acionou com esse ID, por exemplo, ao consultar posteriormente um estado atualizado do alerta. |
|
|
Categoria de alerta
|
category | string |
Nome de uma categoria de sistema ou dispositivo na sua equipa SIGNL4 à qual este alerta deve pertencer. |
|
|
ID exclusivo deste anexo em SIGNL4
|
id | string |
ID exclusivo deste anexo em SIGNL4. |
|
|
Codificação de anexos
|
encoding | integer |
Indica se o conteúdo é codificado em Base64 (1) ou não (0). |
|
|
Nome do anexo
|
name | True | string |
Nome deste anexo, por exemplo, um nome de ficheiro de imagem original. |
|
Tipo MIME de anexo
|
contentType | True | string |
Tipo de conteúdo MIME deste anexo, como imagem/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 deste parâmetro, por exemplo, temperatura. |
|
Tipo de parâmetro
|
type | integer |
Tipo deste parâmetro. Este campo é reservado para uso posterior e deve sempre corresponder a 0 ao configurá-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 da indicação, 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". |
Devoluções
- Body
- AlertInfo
Confirmar tudo
Esse método confirma todos os alertas não tratados que sua equipe tem atualmente.
Obter relatório de alerta
Retorna informações sobre o volume de alertas ocorridos em diferentes períodos de tempo, bem como informações sobre o comportamento de resposta (quantidade de alertas confirmados e não tratados) dos membros da sua equipe.
Devoluções
Um objeto que contém informações sobre o volume de alertas ocorrido em diferentes períodos de tempo, bem como informações sobre o comportamento de resposta (quantidade de alertas confirmados e não tratados) dos membros da sua equipe.
- Um objeto que contém informações sobre o volume de alerta ocorrido em diferentes períodos de tempo
- AlertReport
Obter todos os usuários
Retorna uma lista de objetos de usuário com detalhes como seu endereço de e-mail. Somente os usuários que fazem parte da sua equipe serão retornados.
Devoluções
- Itens
- GetAllUsers_Response
Obter usuário por id
Retorna os detalhes de um usuário, como nome, endereço de e-mail, etc.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do Utilizador
|
userId | True | string |
Identificador do usuário a ser obtido. Use 'Eu' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de e-mail de um usuário na equipe ou o id exclusivo de um objeto de usuário de acordo. |
Devoluções
Informações básicas sobre um usuário.
- Body
- UserInfo
Punch usuário em
Usando esta operação, o usuário especificado será perfurado para o dever.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do Utilizador
|
userId | True | string |
Identificador do usuário a ser inserido. Use 'Eu' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de e-mail de um usuário na equipe ou o id exclusivo de um objeto de usuário de acordo. |
Devoluções
Informações sobre o status de dever de um usuário.
- Body
- UserDutyInfo
Punch usuário para fora
Usando esta operação, o usuário especificado será perfurado fora de serviço.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do Utilizador
|
userId | True | string |
Identificador do usuário a ser perfurado. Use 'Eu' para obter informações sobre o usuário conectado no momento. Também pode ser um endereço de e-mail de um usuário na equipe ou o id exclusivo de um objeto de usuário de acordo. |
Devoluções
Informações sobre o status de dever de um usuário.
- Body
- UserDutyInfo
Definições
Informações do usuário
Informações básicas sobre um usuário.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Utilizador
|
id | string |
ID do utilizador. |
|
Email
|
string |
O endereço de e-mail do usuário. |
|
|
Nome
|
name | string |
Nome do usuário. |
|
ID da Subscrição
|
subscriptionId | string |
ID da subscrição a que o utilizador pertence. |
AlertInfo
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do alerta
|
id | string |
ID exclusivo do alerta em SIGNL4. |
|
Identificação externa
|
externalId | string |
Um ID exclusivo no seu sistema para referenciar este alerta. Pode utilizar este campo para fazer corresponder os alertas que acionou com esse ID, por exemplo, ao consultar posteriormente um estado atualizado do alerta. |
|
ID da subscrição
|
subscriptionId | string |
ID exclusivo da sua subscrição SIGNL4. |
|
Identificação da equipa
|
teamId | string |
ID único da sua equipa SIGNL4. |
|
ID da categoria
|
categoryId | string |
ID exclusivo de um sistema ou categoria de dispositivo na sua equipa SIGNL4 à qual este alerta pertence. |
|
Categoria do sistema ou dispositivo
|
category | string |
Nome de uma categoria de sistema ou dispositivo na sua equipa SIGNL4 à qual este alerta pertence. |
|
Severidade do alerta
|
severity | integer |
Severidade deste alerta no SIGNL4. Este campo está reservado para utilização posterior. |
|
ID exclusivo da API ou fonte através da qual este alerta foi acionado para sua equipe SIGNL4
|
eventSourceId | string |
ID exclusivo da API ou fonte através da qual este alerta foi acionado para sua equipe SIGNL4. |
|
Tipo de API ou fonte através da qual este alerta foi acionado para sua equipe SIGNL4
|
eventSourceType | integer |
Tipo de API ou fonte através da qual este alerta foi acionado para sua equipe SIGNL4. |
|
Hora em que este alerta foi modificado pela última vez no SIGNL4
|
lastModified | date-time |
Hora em que este alerta foi modificado pela última vez no SIGNL4. |
|
Coleção de anexos, tais como imagens que pertencem a este alerta
|
attachments | array of object |
Coleção de anexos, como imagens que pertencem a este alerta. |
|
ID exclusivo destes anexos em SIGNL4
|
attachments.id | string |
ID exclusivo destes 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 deste anexo, por exemplo, um nome de ficheiro de imagem original. |
|
Tipo de conteúdo MIME
|
attachments.contentType | string |
Tipo de conteúdo MIME deste anexo, como image/jpg. |
|
Conteúdo do anexo
|
attachments.content | string |
O conteúdo deste 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 desta anotação. Este campo está reservado para utilização posterior. |
|
Anotação do usuário
|
annotations.text | string |
A anotação que foi deixada por um usuário. |
|
ID exclusivo do usuário SIGNL4 que deixou a anotação
|
annotations.userId | string |
ID exclusivo do usuário SIGNL4 que deixou a anotação. |
|
Uma coleção de pares chave/valor com parâmetros adicionais do dispositivo ou do sistema que pertencem a este alerta
|
parameters | array of object |
Uma coleção de pares chave/valor com parâmetros adicionais do dispositivo ou do sistema que pertencem a este alerta. |
|
Nome do parâmetro
|
parameters.name | string |
Nome deste parâmetro, por exemplo, temperatura. |
|
Tipo de parâmetro
|
parameters.type | integer |
Tipo deste parâmetro. Este campo é reservado para uso posterior e deve sempre corresponder a 0 ao configurá-lo. |
|
Valor do parâmetro
|
parameters.value | string |
O valor do parâmetro, por exemplo, 56F. |
|
Momento em que este alerta foi confirmado
|
history.acknowledged | date-time |
Momento em que este alerta foi confirmado. |
|
Nome do membro da equipa que confirmou o alerta
|
history.acknowledgedBy | string |
Nome do membro da equipa que confirmou o alerta. |
|
Hora em que este alerta foi encerrado
|
history.closed | date-time |
Hora em que este alerta foi encerrado. |
|
Nome do membro da equipa que fechou o alerta
|
history.closedBy | string |
Nome do membro da equipa que fechou o alerta. |
|
Hora em que este alerta foi criado no SIGNL4
|
history.created | date-time |
Hora em que este alerta foi criado no SIGNL4. |
|
Estado do alerta
|
status | integer |
Status do alerta em SIGNL4. 1 representa um alerta não tratado 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 deste 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 alertas ocorrido em diferentes períodos de tempo, bem como informações sobre o comportamento de resposta (quantidade de alertas confirmados e não tratados) dos membros da sua equipe.
| Name | 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. |
|
Momento em que este período terminou ou terminará
|
last24Hours.end | date-time |
Momento em que este período de tempo terminou ou terminará. |
|
Última vez que esta métrica foi alterada
|
last24Hours.lastModified | date-time |
Da última vez, essa métrica mudou. |
|
Momento em que este período de tempo começou ou começará
|
last24Hours.start | date-time |
Momento em que este período de tempo começou ou terá início. |
|
Quantidade de alertas que ocorreram nas últimas 24h e sua equipe não confirmou dentro desse tempo
|
last24Hours.unhandled | integer |
Quantidade de alertas que ocorreram nas últimas 24h e sua equipe não confirmou dentro desse tempo. |
|
ID exclusivo da sua subscrição SIGNL4
|
subscriptionId | string |
ID exclusivo da sua subscrição SIGNL4. |
|
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe confirmou dentro desse tempo
|
teamCurrentDuty.acknowledged | integer |
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe confirmou dentro desse tempo. |
|
Momento em que este período de serviço terminou ou terminará
|
teamCurrentDuty.end | date-time |
Momento em que este período de serviço terminou ou terminará. |
|
Última vez que esta métrica foi alterada
|
teamCurrentDuty.lastModified | date-time |
Da última vez, essa métrica mudou. |
|
Momento em que este período de serviço começou ou começará
|
teamCurrentDuty.start | date-time |
Momento em que este período de serviço começou ou terá início. |
|
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe não confirmou dentro desse tempo
|
teamCurrentDuty.unhandled | integer |
Quantidade de alertas que ocorreram no período de serviço atual e sua equipe não confirmou dentro desse tempo. |
|
ID exclusivo da equipe SIGNL4 para a qual este relatório de alerta foi criado/solicitado. Ficará vazio se a sua equipa tiver desligado o assistente de serviço SIGNL4
|
teamId | string |
ID exclusivo da equipe SIGNL4 para a qual este relatório de alerta foi criado/solicitado. Ficará vazio se a sua equipa 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 tempo
|
teamLastDuty.acknowledged | integer |
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe confirmou dentro desse tempo. |
|
Momento em que este período de serviço terminou ou terminará
|
teamLastDuty.end | date-time |
Momento em que este período de serviço terminou ou terminará. |
|
Última vez que esta métrica foi alterada
|
teamLastDuty.lastModified | date-time |
Da última vez, essa métrica mudou. |
|
Momento em que este período de serviço começou ou começará
|
teamLastDuty.start | date-time |
Momento em que este período de serviço começou ou terá início. |
|
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe não confirmou dentro desse tempo
|
teamLastDuty.unhandled | integer |
Quantidade de alertas que ocorreram no período de serviço anterior e sua equipe não confirmou dentro desse tempo. |
|
ID exclusivo do usuário SIGNL4 para o qual este relatório de alerta foi criado/solicitado. Ficará vazio se a sua equipa tiver ligado o assistente de serviço SIGNL4
|
userId | string |
ID exclusivo do usuário SIGNL4 para o qual este relatório de alerta foi criado/solicitado. Ficará vazio se a sua equipa tiver ligado o assistente de serviço SIGNL4. |
|
Quantidade de alertas que ocorreram desde que o status de serviço dos usuários mudou da última vez e ela confirmou dentro desse tempo
|
userLastDutyChange.acknowledged | integer |
Quantidade de alertas que ocorreram desde que o status de plantão dos usuários mudou da última vez e ela confirmou dentro desse tempo. |
|
Momento em que este período terminou ou terminará
|
userLastDutyChange.end | date-time |
Momento em que este período terminou ou terminará. |
|
últimaModificação
|
userLastDutyChange.lastModified | date-time | |
|
Momento em que este período começou ou terá início
|
userLastDutyChange.start | date-time |
Momento em que este período começou ou terá início. |
|
Quantidade de alertas que ocorreram desde que o status de serviço dos usuários mudou da última vez e ela não confirmou dentro desse tempo
|
userLastDutyChange.unhandled | integer |
Quantidade de alertas que ocorreram desde que o status de plantão dos usuários mudou da última vez e ela não confirmou dentro desse tempo. |
UserDutyInfo
Informações sobre o status de dever de um usuário.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Punch In Date-Time
|
lastChange | date-time |
A data-hora no formato UTC. ex. aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC) |
|
Plantão
|
onDuty | boolean |
True se o usuário estiver de plantão. |
|
Em atraso
|
overdue | boolean |
True se o usuário estiver atrasado no momento, por exemplo, porque ninguém mais substituiu esse usuário a tempo. |
GetAllUsers_Response
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
UserInfo |
Informações básicas sobre um usuário. |