作用

当您在企业直播控制台的消息中心接收到以下类型的消息时，企业直播会对所设置的接口地址进行回调通知：

• 直播违规警告
• 直播违规中断
• 评论举报
• 直播举报

配置方式

完成回调配置。详见回调配置。

详情

完成回调配置后，当接收到违规和举报消息时，企业直播系统会将接收消息的主账号 ID、相关直播间 ID、创建直播间的子账号名称、消息类型、消息具体内容等信息以 POST 方式提交给您设置的回调地址。请求示例如下所示。

• 直播违规警告信息示例：

  POST /xxxxx HTTP/1.1
  Header1: ...
  Header2: ...
  ...
  {
    "AccountId": "200000****",
    "ActivityId": "182573526550****",
    "ActivityName": "直播间 A",
    "ActivityTags": "{\"SelectTags\":[{\"Name\":\"标签 1\",\"Index\":1,\"Value\":\"A\",\"TagType\":0},{\"Name\":\"标签 2\",\"Index\":2,\"Value\":\"B\",\"TagType\":0}],\"TextTags\":[{\"Name\":\"标签 3\",\"Index\":0,\"Value\":\"C\",\"TagType\":1},{\"Name\":\"标签 4\",\"Index\":1,\"Value\":\"D\",\"TagType\":1}]}",
    "EventType": "WarningReportCallback",
    "MessageContent": "
  您的直播【直播间 A】在2022-12-02 19:17:49因涉及展示或谈论敏感事件问题被警告，请及时规范直播内容，如涉及违规立即中断。注意被警告或中断的直播无法生成回放。",
    "MessageType": "3",
    "RequestUuid": "WarningReportCallback-185161483510****",
    "Sign": "f3227d*********f740dc9c9",
    "SubAccountName": "admin@bytedance.com",
    "Timestamp": "1765981314"
  }
  

• 直播举报信息示例：

  POST /xxxxx HTTP/1.1
  Header1: ...
  Header2: ...
  ...
  {
      "AccountId": "200000****",
      "ActivityId": "182573526550****",
      "ActivityName": "直播间 A",
      "ActivityTags": "{\"SelectTags\":[{\"Name\":\"标签 1\",\"Index\":1,\"Value\":\"A\",\"TagType\":0},{\"Name\":\"标签 2\",\"Index\":2,\"Value\":\"B\",\"TagType\":0}],\"TextTags\":[{\"Name\":\"标签 3\",\"Index\":0,\"Value\":\"C\",\"TagType\":1},{\"Name\":\"标签 4\",\"Index\":1,\"Value\":\"D\",\"TagType\":1}]}",
      "EventType": "WarningReportCallback",
      "MessageContent": "观众 A 在直播间 北京分会场 发起举报，举报原因：侮辱谩骂，举报描述： 这个直播间不太好",
      "RelatedScreenShot": "https://livesaas.zebracdn.com/tos-cn-i-xtjplaems7/e620808e5f3f42928f2c0eac64e5b78f~tplv-xtjplaems7-image.image?sign=1765982056-rand-imagex-5dd3b5ab0fd27234819e53**********",
      "MessageType": "11",
      "RequestUuid": "WarningReportCallback-185175755472****",
      "Sign": "ef9********636181d9c448c2d14c768",
      "SubAccountName": "admin@bytedance.com",
      "Timestamp": "1765982056"
  }
  

超时重试

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数

回调请求体为一个 JSON 对象，包含以下参数。

ActivityTags

ActivityTag