CSS supports callbacks. To use this feature, you need to create a callback template in the console, configure an address to receive callbacks for an event, and then bind the template with your push domain name. If the event configured in the template triggers a callback during live streaming, Tencent Cloud will send a request to your server, which is responsible for responding to the request. After successful verification, the server will obtain a JSON packet of the callback through the address configured for the event.
This document describes how to create, modify and delete a callback template in the console.

You can create a callback template in the following ways:

• Create a template in the CSS console. For details, see Creating a Callback Template.
• Create a template with APIs. For specific parameters and samples, see CreateLiveCallbackTemplate.

Notes

• After creating a template, you need to bind it with a push domain name. The binding takes effect in about 5-10 minutes.
• The HTTP or HTTPS server, whose address is configured as the callback address in the template to receive the callback, must be able to receive the request and respond normally.
• In the console, you can manage callback templates by domain name, but cannot cancel rules created by APIs. If you bound a template with a specified stream through callback APIs and want to unbind them, you need to call the DeleteLiveCallbackRule API.
• For more information on live stream callback protocols, see Event Message Notification Protocol.
• For more information on live stream callback notification parameters, see the following:
  • Push event notification
  • Stream interruption event notification
  • Recording event notification
  • Screencapture event notification
  • Porn detection event notification

Creating Callback Template

1. Log in to the CSS console.
2. Select Event Center > Live Stream Callback in the left sidebar.
3. Click Create Callback Template, fill in the information, select the types of callbacks you want to receive, enter the callback URLs, and click Save.
   

   Configuration Item	Description
   Template Name	Name of the callback template, which can contain up to 30 letters, digits, underscores (_), and hyphens (-).
   Template Description	Description of the callback template, which can contain up to 100 letters, digits, underscores (_), and hyphens (-).
   Callback Key	Custom callback key. It can contain up to 32 letters, digits, underscores (_), and hyphens (-). For details, see Event Message Notification Common Parameters.
   Push Callback	Enter an address starting with `http`, `https`, etc. to receive push callbacks.
   Interruption Callback	Enter an address starting with `http`, `https`, etc. to receive stream interruption callbacks.
   Recording Callback	Enter an address starting with `http`, `https`, etc. to receive recording callbacks.
   Screencapture Callback	Enter an address starting with `http`, `https`, etc. to receive screencapture callbacks.
   Porn Detection Callback	Enter an address starting with `http`, `https`, etc. to receive porn detection callbacks.

Modifying Callback Template

1. Select Event Center > Live Stream Callback.
2. Select the target callback template and click Edit to modify its information.
3. After modification, click Save.

Deleting Callback Template

If a template is bound to a domain name, you need to unbind it before you can delete it. For detailed directions, see Unbinding Callback Template.

1. Select Event Center > Live Stream Callback.
2. Find the target callback template, and click Delete.
3. In the pop-up, click Confirm.