Message sent
The message:send event fires after a message is successfully sent and accepted by Nexconn, regardless of channel type. Use this event for real-time message archiving, analytics, or downstream integrations.
For the complete webhook setup and signature verification guide, see Webhooks overview.
Event type
message:send
Payload
Envelope
| Field | Type | Required | Description |
|---|---|---|---|
type | String | Yes | "message:send" |
id | String | Yes | Unique event ID. |
time | Long | Yes | Event generation time (Unix ms). |
data | Array | Yes | Array containing one message object. See Data fields. |
Data fields
| Field | Type | Required | Description |
|---|---|---|---|
userId | String | Yes | The sender's user ID. |
channelId | String | Yes | Target ID: the recipient user ID (direct), group ID, open channel ID, or community channel ID. |
messageType | String | Yes | Message type identifier (e.g., RC:TxtMsg, RC:ImgMsg). See the message type documentation. |
content | String | Yes | Message content body. Structure varies by messageType. |
channelType | Number | Yes | Channel type. See Channel types. |
time | Long | Yes | Time the server received the message (Unix ms). |
messageId | String | Yes | Unique message identifier. |
os | String | Yes | Sender's platform. One of: iOS, Android, Websocket, Server. |
originalMessageId | String | No | Original message ID. Only present in community channels when a message is updated, its metadata is changed, or it is deleted. |
profanityType | Int | No | Profanity detection result. 0 = none. 1 = blocked. 2 = replaced. |
busChannelId | String | No | Subchannel ID. Only present in community channels. |
groupUserIds | String[] | No | Recipient user ID array for targeted group messages. Only present for directed group messages. |
aiGenerated | Boolean | No | Whether the message was generated by AI. Only returned when the feature is enabled for your app. |
Example
JSON
{
"type": "message:send",
"id": "550e8400-e29b-41d4-a716-446655440007",
"time": 1730192400000,
"data": [
{
"userId": "user_001",
"channelId": "group_001",
"messageType": "RC:TxtMsg",
"content": "{\"content\":\"Hello\",\"extra\":\"\"}",
"channelType": 3,
"time": 1730192400000,
"messageId": "msg_xyz789",
"profanityType": 0,
"os": "iOS"
}
]
}