SDKAppID
contained in the request URL is the SDKAppID
of the app.sendmsg
RESTful API.https://www.example.com
.
Example: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 | Callback URL |
SdkAppid | SDKAppID assigned by the IM console when an app is created |
CallbackCommand | The value is always C2C.CallbackAfterSendMsg . |
contenttype | The value is always JSON . |
ClientIP | IP address of the client, such as 127.0.0.1 |
OptPlatform | Platform of the client. For more information about valid values, see the description of OptPlatform in the Callback Protocols section of Third-Party Callback Overview. |
{"CallbackCommand": "C2C.CallbackAfterSendMsg", // Callback command"From_Account": "jared", // Sender"To_Account": "Jonh", // Recipient"MsgSeq": 48374, // Sequence number of the message"MsgRandom": 2837546, // Random number of the message"MsgTime": 1557481126, // Timestamp in seconds indicating when the message is sent"MsgKey": "48374_2837546_1557481126", // Unique identifier of the message. It can be used to recall the message via a RESTful API call."OnlineOnlyFlag":1, // The value is `1` if it is an online message and `0` if it's not"SendMsgResult": 0, // Message sending result"ErrorInfo": "send msg succeed", // Error information related to the failure to send the message. If the message is sent successfully, the value of this field is `send msg succeed`."UnreadMsgNum": 7, // Total number of unread one-to-one messages of `To_Account`"MsgBody": [ // Message body{"MsgType": "TIMTextElem", // Text"MsgContent": {"Text": "red packet"}}],"CloudCustomData": "your cloud custom data"}
Field | Type | Description |
CallbackCommand | String | Callback command |
From_Account | String | UserID of the message sender |
To_Account | String | UserID of the message recipient |
MsgSeq | Integer | Sequence number of the message. It is used to identify the message and the value is a random 32-bit unsigned integer. |
MsgRandom | Integer | Random number of the message. It is used to identify the message and the value is a random 32-bit unsigned integer. |
MsgTime | Integer | Timestamp in seconds indicating when the message is sent. One-to-one messages are preferentially sorted by MsgTime . Messages sent in the same second are sorted by MsgSeq . Messages with larger values of MsgSeq are after those with smaller values of MsgSeq . |
MsgKey | String | |
MsgId | String | Unique identifier of the message on the client. |
OnlineOnlyFlag | Integer | The value is 1 if it means only to online users and 0 if it's not. |
SendMsgResult | Integer | |
ErrorInfo | String | Error information related to the failure to send the message. If the message is sent successfully, the value of this field is send msg succeed . |
UnreadMsgNum | Integer | Total number of unread one-to-one messages of To_Account (including all one-to-one conversations). If the message fails to be sent, for example, due to filtering of restricted words, the value of this field is -1 . |
MsgBody | Array | |
CloudCustomData | String | 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. |
{"ActionStatus":"OK","ErrorInfo": "","ErrorCode": 0 // `0`: callback succeeds; `1`: an error occurs during callback.}
Field | Type | Required | Description |
ActionStatus | String | Yes | Request result. OK : successful; FAIL : failed |
ErrorCode | Integer | Yes | Error code. 0 : callback succeeds; 1 : an error occurs during callback. |
ErrorInfo | String | Yes | Error information |
Was this page helpful?