Message

The message object is the very soul of a conversation. It encapsulates all the information need in order to represent a single entry on a message list.

The message object contains these fields:

  • _id: The message id

  • rid: The room id - Identify the room the message belongs

  • msg: The textual message

  • ts: The message time stamp (date of creation on client)

  • u: The user that sent the message

  • _updatedAt: The time stamp when the message got saved on the server

  • editedAt: (Optional) The time stamp of when the message was edited

  • editedBy: (Optional) The user that edited the message

  • urls: (Optional) A collection of URLs metadata. Available when the message contains at least one URL

  • attachments: (Optional) A collection of attachment objects, available only when the message has at least one attachment

  • alias: (Optional) A way to display the message is "sent" from someone else other than the user who sent the message

  • avatar: (Optional) A url to an image, that is accessible to anyone, to display as the avatar instead of the message user's account avatar

  • groupable: (Optional) Boolean that states whether or not this message should be grouped together with other messages from the same user

  • parseUrls: (Optional) Whether Rocket.Chat should try and parse the urls or not

The user presented on u and editedBy fields are a simplified version of the user information:

  • _id: The user id

  • username: The username

The URL metadata contains several informational fields:

  • url: The URL itself (just as it appears on the message)

  • meta: URL metadata (varies accord to the URL)

  • headers: Some HTTP headers (varies accord to the URL)

  • parsedUrl: The parsed URL broken into its parts

The attachment object is fully described here

{
"messages": [
{
"_id": "message-id",
"rid": "room-id",
"msg": "Hello World!",
"ts": { "$date": 1480377601 },
"u": {
"_id": "user-id",
"username": "username"
},
"_updatedAt": { "$date": 1480377601 }
},
{
"_id": "message-id",
"rid": "room-id",
"msg": "Hello!",
"ts": { "$date": 1480377601 },
"u": {
"_id": "user-id",
"username": "username"
},
"_updatedAt": { "$date":1480377601 },
"editedAt": { "$date": 1480377601 },
"editedBy": {
"_id": "user-id",
"username": "username"
}
}
]
}
Edit on GitHub