Skip to main content

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

FieldTypeRequiredDescription
typeStringYes"message:send"
idStringYesUnique event ID.
timeLongYesEvent generation time (Unix ms).
dataArrayYesArray containing one message object. See Data fields.

Data fields

FieldTypeRequiredDescription
userIdStringYesThe sender's user ID.
channelIdStringYesTarget ID: the recipient user ID (direct), group ID, open channel ID, or community channel ID.
messageTypeStringYesMessage type identifier (e.g., RC:TxtMsg, RC:ImgMsg). See the message type documentation.
contentStringYesMessage content body. Structure varies by messageType.
channelTypeNumberYesChannel type. See Channel types.
timeLongYesTime the server received the message (Unix ms).
messageIdStringYesUnique message identifier.
osStringYesSender's platform. One of: iOS, Android, Websocket, Server.
originalMessageIdStringNoOriginal message ID. Only present in community channels when a message is updated, its metadata is changed, or it is deleted.
profanityTypeIntNoProfanity detection result. 0 = none. 1 = blocked. 2 = replaced.
busChannelIdStringNoSubchannel ID. Only present in community channels.
groupUserIdsString[]NoRecipient user ID array for targeted group messages. Only present for directed group messages.
aiGeneratedBooleanNoWhether 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"
}
]
}