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/ |
| 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
- Items
- GetAllUsers_Response
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.
- Body
- UserDutyInfo
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.
- Body
- UserDutyInfo
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
|
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. |