# 反馈举报信息回调通知

**作用**

使用本功能，用户发起反馈/举报后，服务端会对客户所设置的接口地址，以**POST**方式提交到给用户自定义的回调接口进行通知。

### 超时重试

1、回调服务器在发送消息通知后，5秒内没有收到您的服务器的响应，即认为通知失败。后续失败会以5秒间隔继续重试2次。 2、接口返回json对象，如果回调没有返回200，会重试2次，超过2次则丢弃日志

### 回调消息格式

事件回调消息以 HTTP/HTTPS POST 请求发送给您的服务器，其中：

* 字符编码格式：UTF-8。
* 请求：body 格式为 JSON。
* 应答要求：响应头需指定Content-Type: application/json；
* 正确应答：http status code: 200为正确业务接收处理，其他状态一律视为失败重试处理 。

### 回调参数说明

| 参数名         | 类型及范围  | 说明                                                                                                                                                                                                                                                                                   |
| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| userId      | string | 直播账号id                                                                                                                                                                                                                                                                               |
| channelId   | string | 频道号                                                                                                                                                                                                                                                                                  |
| channelName | string | 频道名称                                                                                                                                                                                                                                                                                 |
| viewerId    | string | 观众id                                                                                                                                                                                                                                                                                 |
| viewerName  | string | 观众昵称                                                                                                                                                                                                                                                                                 |
| createdTime | string | 发起时间（格式：yyyyMMddHHmmss）                                                                                                                                                                                                                                                              |
| type        | string | <p>类型<br>complaint：举报<br>suggestion：反馈</p>                                                                                                                                                                                                                                           |
| label       | string | <p>举报分类<br>porn：色情低俗<br>bloody：恐怖血腥<br>scam：欺诈信息<br>uncivilized：发言不雅<br>illegal-entry：成员乱入<br>infringe-right：侵犯权益<br>other-violations：其他举报<br>反馈分类<br>stuck：页面卡顿<br>black-screen：画面黑屏<br>slow-access：访问缓慢<br>poor-experience：体验不好<br>play-suggestion：玩法建议<br>other-feedback：其他反馈</p> |
| content     | string | 内容                                                                                                                                                                                                                                                                                   |
| imageUrls   | array  | 图片url                                                                                                                                                                                                                                                                                |
| contact     | string | 联系方式                                                                                                                                                                                                                                                                                 |
| actor       | string | 主讲头衔                                                                                                                                                                                                                                                                                 |
| teacherName | string | 主讲昵称                                                                                                                                                                                                                                                                                 |

### 回调数据示例

响应体：

```json
{
  "userId": "43231hnaa2",
  "channelId": 2191532,
  "channelName": "测试",
  "viewerId": "1676254629615",
  "createdTime": "20230213112103",
  "type": "suggestion",
  "label": "stuck",
  "content": "123123",
  "imageUrls": ["http://liveimages.videocc.net/watch-feedback/43f5f9caa2/3757791/1676258463568_37rXln.jpeg"],
  "contact": "",
  "actor": "讲师",
  "teacherName": "讲师"
}
```

### 如何设置

通过后台设置：

登录账户 - 进入【云直播】 - 点击【开发设置】- 点击【回调设置】- 直播间一键举报信息回调

注意：提交的接口地址必须要以 http:// 或者 https:// 开头
