Executing webhooks
Webhooks are automatically executed by HCL Compass. JSON is sent to the URL of the webhook configuration when an event happens that matches a state or action for the configuration.
In the following sample webhook payload, the webUrl
is the URL of the
relevant configuration. The content object is the entire contents of the record that was
actioned or had its state changed to match the configuration. Each field indicates
whether the field is truncated. If the truncated
value is
true
, there is an additional key/value pair that provides the REST
URL to access the entire contents of the relevant field. The field is truncated if it is
greater than or equal to 5,000 characters.
{
"webUrl": "https://yoursitename.com/post",
"content": {
"esig_login": {
"truncated": "false",
"value": ""
},
"Owner": {
"truncated": "false",
"value": "lead"
},
"Keywords": {
"url": "https://localhost:8190/ccmweb/rest/repos/5.0.0/databases/SAMPL/records/Defect/SAMPL00000084/fields/Description"
"truncated": "true",
"value": "<Full text will appear here. The value is truncated when it is equal to or less than 5,000 characters.>"
},
"Description": {
"truncated": "false",
"value": ""
},
"ratl_mastership": {
"truncated": "false",
"value": "<local>"
},
"is_duplicate": {
"truncated": "false",
"value": "0"
},
"Attachments": {
"truncated": "false",
"value": ""
},
"Submitter": {
"truncated": "false",
"value": "admin"
},
"Headline": {
"truncated": "false",
"value": "Example Defect"
},
"esig_is_current": {
"truncated": "false",
"value": "False"
},
"esig_log": {
"truncated": "false",
"value": ""
},
"id": {
"truncated": "false",
"value": "SAMPL00000074"
},
"Note_Entry": {
"truncated": "false",
"value": ""
},
"is_active": {
"truncated": "false",
"value": "1"
},
"lock_version": {
"truncated": "false",
"value": "0"
},
"Priority": {
"truncated": "false",
"value": "3-Normal Queue"
},
"esig_password": {
"truncated": "false",
"value": ""
},
"unduplicate_state": {
"truncated": "false",
"value": ""
},
"Severity": {
"truncated": "false",
"value": "4-Minor"
},
"history": {
"truncated": "false",
"value": "33555052\t2020-11-10 14:45:47\tadmin\tSubmit\tno_value\tSubmitted"
},
"version": {
"truncated": "false",
"value": "1"
},
"record_type": {
"truncated": "false",
"value": "Defect"
},
"Notes_Log": {
"truncated": "false",
"value": ""
},
"esig_signed_for_delete": {
"truncated": "false",
"value": "0"
},
"customer_severity": {
"truncated": "false",
"value": ""
},
"Submit_Date": {
"truncated": "false",
"value": "2020-11-10 14:42:09"
},
"Project": {
"truncated": "false",
"value": "Classics"
},
"locked_by": {
"truncated": "false",
"value": ""
},
"State": {
"truncated": "false",
"value": "Submitted"
},
"dbid": {
"truncated": "false",
"value": "33554506"
},
"old_id": {
"truncated": "false",
"value": ""
},
"Symptoms": {
"truncated": "false",
"value": ""
},
"Resolution_Statetype": {
"truncated": "false",
"value": "Not_Resolved"
},
"Resolution": {
"truncated": "false",
"value": ""
},
"customer": {
"truncated": "false",
"value": ""
}
}
}
Users with the proper permissions can query on the WebhookData record type and view the status code, response message, retry counter, and other information related to pending payload deliveries. If the remote system does not catch the webhook, HCL Compass automatically retries to deliver the payload up to 10 times. For more information about queries on webhooks, see Managing and debugging webhooks.