Share via


Derdack SIGNL4

Derdack SIGNL4 is a mobile notification app to reliably notify operations teams on duty and boost their productivity.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
URL https://www.signl4.com/feedback-we-love-hear-from-you/
Email info@signl4.com
Connector Metadata
Publisher Derdack GmbH
Website https://www.signl4.com
Privacy policy https://www.signl4.com/privacy-policy/

The SIGNL4 connector allows you to

  • Send persistent mobile alerts notifications with automated escalations
  • Track delivery and confirmations
  • Route alerts to the right people by considering timely availability of team members (e.g. on-call duty, shifts)
  • Gain transparency on alert ownership and response

Use the SIGNL4 connector to send alerts on any triggers or from any 3rd system. It also allows you to extend existing SIGNL4 uses cases. For example, you can punch a user in or out of duty based on calendars in Microsoft Office 365, Microsoft StaffHub, Google Calendars and more. Another scenario is the extraction of shift performance metrics (e.g. alert response, on duty times) from SIGNL4 into a custom audit trail, such as a simple csv file, on a regular basis.

When you create a connection to SIGNL4, simply login with your SIGNL4 user credentials (or any other supported account such as your Microsoft work or school account) and give your consent on requested permissions. You will afterwards be able to invoke all actions of the API on your SIGNL4 team scope. This means that you can e.g. punch in other people in your team for on-call duty but no one from other SIGNL4 teams.

More information on the product and the API be found online at https://www.signl4.com/.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Confirm all

This method confirms all unhandled alerts your team currently has.

Get Alert Report

Returns information about the occurred alert volume in different time periods as well as information about the response behavior (amount of confirmed and unhandled alerts) of your team members.

Get all Users

Returns a list of user objects with details such as their email address. Only users who are part of your team will be returned.

Get user by id

Returns a user's details such as name, email address, etc.

Punch user in

Using this operation, the specified user will be punched in to duty.

Punch user out

Using this operation, the specified user will be punched out from duty.

Trigger Alert

Triggers a new alert for your team. All team members on duty will receive alert notifications.

Confirm all

This method confirms all unhandled alerts your team currently has.

Get Alert Report

Returns information about the occurred alert volume in different time periods as well as information about the response behavior (amount of confirmed and unhandled alerts) of your team members.

Returns

An object holding information about the occurred alert volume in different time periods as well as information about the response behaviour (amount of confirmed and unhandled alerts) of your team members.

An object holding information about the occurred alert volume in different time periods
AlertReport

Get all Users

Returns a list of user objects with details such as their email address. Only users who are part of your team will be returned.

Returns

Get user by id

Returns a user's details such as name, email address, etc.

Parameters

Name Key Required Type Description
User Id
userId True string

Identifier of the user to get. Use 'Me' to get information about the currently logged in user. Can also be an email address of a user in the team or the unique id of an according user object.

Returns

Basic information about a user.

Body
UserInfo

Punch user in

Using this operation, the specified user will be punched in to duty.

Parameters

Name Key Required Type Description
User Id
userId True string

Identifier of the user to punch in. Use 'Me' to get information about the currently logged in user. Can also be an email address of a user in the team or the unique id of an according user object.

Returns

Information about a user's duty status.

Punch user out

Using this operation, the specified user will be punched out from duty.

Parameters

Name Key Required Type Description
User Id
userId True string

Identifier of the user to punch out. Use 'Me' to get information about the currently logged in user. Can also be an email address of a user in the team or the unique id of an according user object.

Returns

Information about a user's duty status.

Trigger Alert

Triggers a new alert for your team. All team members on duty will receive alert notifications.

Parameters

Name Key Required Type Description
External id
externalId string

A unique id in your system for referencing this alert. You may use this field to match alerts that you have triggered with that id, e.g. when querying for an updated status of the alert later on.

Alert category
category string

Name of a system or device category in your SIGNL4 team to which this alert should belong.

Unique id of this attachment in SIGNL4
id string

Unique id of this attachment in SIGNL4.

Attachment encoding
encoding integer

Indicates if the content is Base64 encoded (1) or not (0).

Attachment name
name True string

Name of this attachment, e.g. an original image file name.

Attachment MIME type
contentType True string

MIME content type of this attachment such as image/jpg (with encoding 1) or text/plain (e.g. with encoding 0).

Attachment data
content True string

Data of this attachment, such as a Base64 string representing a jpg image.

Parameter name
name True string

Name of this parameter, e.g. temperature.

Parameter type
type integer

Type of this parameter. This field is reserved for later use and should always match 0 when setting it.

Parameter value
value True string

The value of the parameter, e.g. 56F.

Alert title
title True string

Title or subject of this alert, e.g. 'Temperature alert'.

Alert details
text True string

Textual alert details, e.g. 'Temperature decreased by 10F within the last 4 minutes'.

Returns

Body
AlertInfo

Definitions

UserInfo

Basic information about a user.

Name Path Type Description
User Id
id string

ID of the user.

Email
mail string

The user's mail address.

Name
name string

Name of the user.

Subscription Id
subscriptionId string

ID of the subscription the user belongs to.

AlertInfo

Name Path Type Description
Alert id
id string

Unique id of the alert in SIGNL4.

External id
externalId string

A unique id in your system for referencing this alert. You may use this field to match alerts that you have triggered with that id, e.g. when querying for an updated status of the alert later on.

Subscription id
subscriptionId string

Unique id of your SIGNL4 subscription.

Team id
teamId string

Unique id of your SIGNL4 team.

Category id
categoryId string

Unique id of a system or device category in your SIGNL4 team to which this alert belongs.

System or device category
category string

Name of a system or device category in your SIGNL4 team to which this alert belongs.

Alert severity
severity integer

Severity of this alert in SIGNL4. This field is reserved for later use.

Unique id of the API or source through which this alert was triggered for your SIGNL4 team
eventSourceId string

Unique id of the API or source through which this alert was triggered for your SIGNL4 team.

Type of the API or source through which this alert was triggered for your SIGNL4 team
eventSourceType integer

Type of the API or source through which this alert was triggered for your SIGNL4 team.

Time at which this alert was last modified in SIGNL4
lastModified date-time

Time at which this alert was last modified in SIGNL4.

Collection of attachmanets such as images that belong to this alert
attachments array of object

Collection of attachmanets such as images that belong to this alert.

Unique id of this attachments in SIGNL4
attachments.id string

Unique id of this attachments in SIGNL4.

Indicates if the content is Base64 or encoded (1) or not (0)
attachments.encoding integer

Indicates if the content is Base64 or encoded (1) or not (0).

Attachment name
attachments.name string

Name of this attachment, e.g. an original image file name.

MIME content type
attachments.contentType string

MIME content type of this attachment such as image/jpg.

Attachment content
attachments.content string

The content of this attachment.

A collection of annotations users have left on this alert
annotations array of object

A collection of annotations users have left on this alert.

Annotation type
annotations.type integer

Type of this annotation. This field is reserved for later use.

User annotation
annotations.text string

The annotation that was left by a user.

Unique id of the SIGNL4 user who has left the annotation
annotations.userId string

Unique id of the SIGNL4 user who has left the annotation.

A collection of of key/value pairs with additional device or system parameters that belong to this alert
parameters array of object

A collection of of key/value pairs with additional device or system parameters that belong to this alert.

Parameter name
parameters.name string

Name of this parameter, e.g. temperature.

Parameter type
parameters.type integer

Type of this parameter. This field is reserved for later use and should always match 0 when setting it.

Parameter value
parameters.value string

The value of the parameter, e.g. 56F.

Time at which this alert was confirmed
history.acknowledged date-time

Time at which this alert was confirmed.

Name of the team member who has confirmed the alert
history.acknowledgedBy string

Name of the team member who has confirmed the alert.

Time at which this alert was closed
history.closed date-time

Time at which this alert was closed.

Name of the team member who has closed the alert
history.closedBy string

Name of the team member who has closed the alert.

Time at which this alert was created in SIGNL4
history.created date-time

Time at which this alert was created in SIGNL4.

Alert status
status integer

Status of the alert in SIGNL4. 1 represents an unhandled alert while 2 represents a confirmed alert. All other values are reserved for later use and should never be a value of an instance of this object.

Alter title
title string

Title or subject of this alert.

Textual alert details
text string

Textual alert details.

AlertReport

An object holding information about the occurred alert volume in different time periods as well as information about the response behaviour (amount of confirmed and unhandled alerts) of your team members.

Name Path Type Description
Amount of alerts that occurred in the last 24h and your team has confirmed within that time
last24Hours.acknowledged integer

Amount of alerts that occurred in the last 24h and your team has confirmed within that time.

Time at which this time period has ended or will end
last24Hours.end date-time

Time at which this time period has ended or will end.

Last time this metric changed
last24Hours.lastModified date-time

Last time this metric changed.

Time at which this time period has started or will start
last24Hours.start date-time

Time at which this time period has started or will start.

Amount of alerts that occurred in the last 24h and your team has not confirmed within that time
last24Hours.unhandled integer

Amount of alerts that occurred in the last 24h and your team has not confirmed within that time.

Unique id of your SIGNL4 subscription
subscriptionId string

Unique id of your SIGNL4 subscription.

Amount of alerts that occurred in the current duty period and your team has confirmed within that time
teamCurrentDuty.acknowledged integer

Amount of alerts that occurred in the current duty period and your team has confirmed within that time.

Time at which this duty period has ended or will end
teamCurrentDuty.end date-time

Time at which this duty period has ended or will end.

Last time this metric changed
teamCurrentDuty.lastModified date-time

Last time this metric changed.

Time at which this duty period has started or will start
teamCurrentDuty.start date-time

Time at which this duty period has started or will start.

Amount of alerts that occurred in the current duty period and your team has not confirmed within that time
teamCurrentDuty.unhandled integer

Amount of alerts that occurred in the current duty period and your team has not confirmed within that time.

Unique id of the SIGNL4 team for which this alert report was created/requested. Will be empty if your team has switched off the SIGNL4 duty assistant
teamId string

Unique id of the SIGNL4 team for which this alert report was created/requested. Will be empty if your team has switched off the SIGNL4 duty assistant.

Amount of alerts that occurred in the previous duty period and your team has confirmed within that time
teamLastDuty.acknowledged integer

Amount of alerts that occurred in the previous duty period and your team has confirmed within that time.

Time at which this duty period has ended or will end
teamLastDuty.end date-time

Time at which this duty period has ended or will end.

Last time this metric changed
teamLastDuty.lastModified date-time

Last time this metric changed.

Time at which this duty period has started or will start
teamLastDuty.start date-time

Time at which this duty period has started or will start.

Amount of alerts that occurred in the previous duty period and your team has not confirmed within that time
teamLastDuty.unhandled integer

Amount of alerts that occurred in the previous duty period and your team has not confirmed within that time.

Unique id of the SIGNL4 user for which this alert report was created/requested. Will be empty if your team has switched on the SIGNL4 duty assistant
userId string

Unique id of the SIGNL4 user for which this alert report was created/requested. Will be empty if your team has switched on the SIGNL4 duty assistant.

Amount of alerts that occurred since the users duty status changed last time and she has confirmed within that time
userLastDutyChange.acknowledged integer

Amount of alerts that occurred since the users duty status changed last time and she has confirmed within that time.

Time at which this period has ended or will end
userLastDutyChange.end date-time

Time at which this period has ended or will end.

lastModified
userLastDutyChange.lastModified date-time
Time at which this period has started or will start
userLastDutyChange.start date-time

Time at which this period has started or will start.

Amount of alerts that occurred since the users duty status changed last time and she has not confirmed within that time
userLastDutyChange.unhandled integer

Amount of alerts that occurred since the users duty status changed last time and she has not confirmed within that time.

UserDutyInfo

Information about a user's duty status.

Name Path Type Description
Punch In Date-Time
lastChange date-time

The date-time in UTC format. ex. yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

On Duty
onDuty boolean

True if the user is on duty.

Overdue
overdue boolean

True if the user is currently overdue, e.g. because nobody else has replaced that user in time.

GetAllUsers_Response

Name Path Type Description
Items
UserInfo

Basic information about a user.