製品アップデート情報
Tencent Cloudオーディオビデオ端末SDKの再生アップグレードおよび承認チェック追加に関するお知らせ
TRTCアプリケーションのサブスクリプションパッケージサービスのリリースに関する説明について
SDKAppID contained in the request URL is the SDKAppID of the app.https://www.example.com.https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform
Parameter | Description |
https | The request protocol is HTTPS, and the request method is POST. |
www.example.com | Webhook URL |
SdkAppid | The SDKAppID assigned by the Chat console when the app is created |
CallbackCommand | Fixed value: Group.CallbackBeforeSendMsg. |
contenttype | Fixed value: json. |
ClientIP | Client IP, such as 127.0.0.1 |
OptPlatform | Client platform. For valid values, see the description of OptPlatform in the Webhook Protocols section of Webhook Callback Overview. |
{"CallbackCommand": "Group.CallbackBeforeSendMsg", // Webhook command"GroupId": "@TGS#2J4SZEAEL", // Room ID"Type": "Live", // Room type"From_Account": "jared", // Sender"Operator_Account":"admin", // Request initiator"Random": 123456, // Random number"MsgId": "144115233406643804-1727580296-4026038328", // Unique identifier of the message on the client"MsgBody": [ // Message body. For more information, see the `TIMMessage` message object.{"MsgType": "TIMTextElem", // Text"MsgContent":{"Text": "red packet"}}],"CloudCustomData": "your cloud custom data","EventTime":"1670574414123"// Event trigger timestamp in milliseconds}
Field | Type | Description |
CallbackCommand | String | Webhook command. |
GroupId | String | ID of the room that generates room messages. |
Type | String | Type of the room that generates room messages, Fixed Live. |
From_Account | String | UserID of the message sender. |
Operator_Account | String | UserID of the request initiator, based on which the system can identify whether the request is initiated by the admin. |
Random | Integer | A 32-bit random number in the request. |
MsgId | String | Unique identifier of the message on the client. |
MsgBody | Array | Message body. The content is related to the message request, as detailed in Send Normal Message and Send Custom Message. |
CloudCustomData | String | Custom message data. It is saved in the cloud and will be sent to the receiver. Such data can be pulled after the app is uninstalled and reinstalled. The content is related to the message request, as detailed in Send Normal Message. |
EventTime | Integer | Event trigger timestamp in milliseconds. |
MsgBody and CloudCustomData are the results of packaging the message send request. For details, see Send Normal Message and Send Custom Message.{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0 // `0` indicates the user is allowed to send messages.}
10016 is returned to the caller.{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 1 // `1` indicates that the user is not allowed to send messages.}
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 2 // The value `2` indicates the message is silently discarded.}
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0, // This field must be set to `0` so that the modified message can be sent normally."MsgBody": [ // Message modified by the app backend. If the app backend does not modify the message, the message sent by the user is delivered.{"MsgType": "TIMTextElem", // Text"MsgContent":{"Text": "red packet"}},{"MsgType": "TIMCustomElem", // Custom message"MsgContent":{"Desc": "CustomElement.MemberLevel", // Description"Data": "LV1" // Data}}],"CloudCustomData": "your cloud custom data"}
Field | Type | Required | Description |
ActionStatus | String | Yes | Request result. OK: Successful; FAIL: Failed. |
ErrorCode | Integer | Yes | Error code returned. 0: allows message sending; 1: forbids message sending; 2: discards the message silently. If the business side wants to forbid a user to send messages and send ErrorCode and ErrorInfo to the client, ensure that the value of ErrorCode is set within the range of [10100, 10200]. |
ErrorInfo | String | Yes | Error information. |
MsgBody | Array | No | Message body modified by the app backend. The Live backend sends the modified message to the room. For more information on the format, see Message Formats. |
CloudCustomData | String | No | Custom message data. It is saved in the cloud and will be sent to the peer end. Such data can be pulled after the app is uninstalled and reinstalled. |
フィードバック