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.