Content Moderation:Configure notifications

Concepts

Before you configure callback notifications, you should understand the concepts described in the following table.

Scan result callback notifications

All asynchronous detection API operations of Content Moderation support scan result callbacks, such as asynchronous image scan and asynchronous video scan. When you make an asynchronous invocation, to receive scan results from Content Moderation, you must include the callback (webhook address) and seed (checksum string) parameters in the request.

Procedure

1. Prepare the HTTP webhook address and seed parameter to receive scan results.

2. When you call an asynchronous Content Moderation API operation, pass the corresponding callback and seed request parameters. For more information, see the parameter descriptions in the API operation documentation.

Human review callback notifications

Human review API operations do not return detection results in real time. Instead, the system uses callbacks to notify the caller.

• Machine-assisted human review

  If you use the Alibaba Cloud human review service combined with the machine-assisted moderation service, you must configure notifications in the console to receive callbacks from the human review module. Follow these steps:

  1. Log on to the Content Moderation console.

  2. In the navigation pane on the left, choose Machine Moderation V1.0 > Settings.

  3. On the Settings page, click the Notification tab, and then click Create New Notification.

  4. In the Create New Notification dialog box, enter a Title and Callback URL. Select an Encryption algorithm, Notification type, and Audit Result. Then, click OK.

     After you save the configuration, the system automatically generates a seed. The seed value is used to verify that the requests received by your webhook address are from Alibaba Cloud. You must save the automatically generated seed.

     Important

     • If you have already configured a callback notification service for machine-assisted moderation, you can reuse the existing configuration or create a new one as needed.

     • The system supports callbacks for all review results. You can also choose to receive callbacks for only some review results depending on your business scenario.

     • For Notification Type, select Manual Review Results by AlibabaCloud.

     • The following encryption algorithm methods are available:

       • SHA256: Uses the HMAC-SHA256 encryption algorithm.

       • SM3: Uses the SM3 encryption algorithm and returns a hexadecimal string of lowercase letters and numbers.

         For example, encrypting abc with SM3 returns 66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0.

  5. On the Scenario Management tab, find the target business scenario, click Associate Notification in the Actions column, and then associate the Callback Notification Plan that you configured.

content description

After you enable callback notifications, Content Moderation sends callback notifications based on your configuration. The callback notification contains form data in the content field. The following table describes the structure of the content field.

{
    "scanResult": {
        "code": 200,
        "msg": "OK",
        "taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
        "url": "http://1.jpg",
        "results": [
            {
                "rate": 100,
                "scene": "porn",
                "suggestion": "block",
                "label": "porn"
            }
        ]
    },
    "auditResult": {
        "suggestion": "block",
        "labels": [
            "porn",
            "ad",
            "terrorism"
        ]
    },
    "humanAuditResult": {
        "suggestion": "pass",
          "dataId": "yyyy",
          "labels": [
              "porn",
              "vulgar"
        ],
        "taskId": "xxxxxx"
    }
}