The flexibility of the SIGNL4 webhook makes it the most powerful one worldwide because it can receive an enormous number of content types and at the same time does not prescribe a fixed schema for the data of the respective type.
Parameter parsing
When your submitted event triggers a Signl, the posted payload (e.g. JSON format) is parsed into Signl parameter details. You can think of the parameters as a collection of parameter / value pairs
Each Signl has two fixed parameters "Title" and "Text".
Your posted JSON is parsed automatically for parameters with these names or similar names. If present, their value is adopted to the "Title" and "Text" parameters of the Signl. If those are not present, the first parameter values which are a text string are taken for "Title" and "Text".
In that case, the original parameters which contained these text values are removed to prevent a duplication of data.
The table below displays all names of received parameters from which the value would be taken into "Title" or "Text" field in the applied search order.
Fixed Signl parameter | Value adoption from first of these parameters, if present and their value type is string |
Title | Title, Subject, Job, Task, Case, Incident |
Text | Text, Message, MessageText, Description, Body, Content |
Fixed Signl parameters are displayed in Signl overviews in the app and may help to quickly understand what it is about.
Attributes of nested JSON objects are mapped to parameter names which contain a dot for each nested layer. The table below displays all the parameters of the signl that would be created for this example event:
POST https://connect.signl4.com/webhook/g93sdfm2843 HTTP/1.1
Host: connect.signl4.com
Connection: keep-alive
Content-Length: 362
Pragma: no-cache
Cache-Control: no-cache
Content-Type: application/json
{
"Title": "Critical production failure",
"Message": "Check line machine C immediately",
"Severity": "High",
"Business Details": {
"Impact": "Major",
"Scope": "Unlimited"
}
}
Parameter name | Parameter value |
Title | Critical production failure |
Text | Check line machine C immediately |
Severity | High |
Business Details.Impact
|
Major |
Business Details.Scope
|
Unlimited |
Comments
0 comments
Please sign in to leave a comment.