Message object

Message is an object that refers to a single message published on a chat channel.

Properties

The Message interface has the following properties:

interface Message {
    val chat: Chat
    val timetoken: Long
    val content: EventContent.TextMessageContent
    val channelId: String
    val userId: String
    val actions: Map<String, Map<String, List<Action>>>?
    val meta: Map<String, Any>?
    val mentionedUsers: MessageMentionedUsers? // deprecated
    val referencedChannels: MessageReferencedChannels? // deprecated
    val quotedMessage: QuotedMessage?
    val text: String
    val deleted: Boolean
    val hasThread: Boolean
    val files: List<File>

show all 20 lines

Parameter	Description
chat Type: Chat	Reference to the main Chat object.
timetoken Type: Long	Unique identifier for the message, possibly a timestamp or similar value that helps order messages in a conversation.
content Type: EventContent.TextMessageContent	Original text content of the message.
channelId Type: String	Unique identifier for the channel or group in which the message was sent.
userId Type: String	Unique ID of the user who sent the message.
actions Type: Map<String, Map<String, List<Action>>>	Any actions associated with the message, such as reactions, replies, or other interactive elements.
meta Type: Map<String, Any>	Extra information added to the message giving additional context. This object can be of any type and can consist of a list of key-value pairs. For example, {language: 'English', wordCount: 42}.
mentionedUsers Type: MessageMentionedUsers	List of mentioned users with IDs and names.
referencedChannels Type: MessageReferencedChannels	List of referenced channels with IDs and names.
quotedMessage Type: QuotedMessage	List of quoted messages with their timetokens, content, and authors' IDs.
text Type: String	Content of the message.
deleted Type: Boolean	Whether the message is soft deleted.
hasThread Type: Boolean	Whether any thread has been created for this message.
files Type: List<File>	List of attached files with their names, types, and sources.
reactions Type: Map<String, List<Action>>	List of reactions attached to the message.
textLinks Type: List<TextLink>	List of included text links and their position.

The TextMessageContent type defined for the Message object takes the following parameters:

@Serializable
sealed class EventContent {

    ...

    @Serializable
    @SerialName("text")
    open class TextMessageContent(
        val text: String,
        val files: List<File>? = null,
    ) : EventContent() {
        override fun equals(other: Any?): Boolean {
            if (this === other) return true
            if (other !is TextMessageContent) return false

show all 34 lines

Depending on how a message was manipulated (what action was taken on it), it is assigned a different action type (for adding a message reaction to a message, editing, or deleting a message). For example, MessageActionType.EDITED.

enum class MessageActionType {
    REACTIONS,
    DELETED,
    EDITED;

    override fun toString(): String {
        return name.lowercase()
    }
}

Message-related types

Methods

You can call the following methods and properties on the Message object.

Click on each method or property for more details.

• createThread()
• createThreadMessageDraft()
• delete()
• deleted
• hasThread
• editText()
• forward()
• getThread()
• hasUserReaction()
• toggleReaction()
• pin()
• quotedMessage
• reactions
• removeThread()
• report()
• restore()
• streamUpdates()
• streamUpdatesOn()
• text
• textlinks

Use case

For example, you can use the Message object methods to:

• Let users send, update, and delete messages.
• Forward messages to others.
• Pin messages to channels.
• Quote messages.
• React to messages.
• Report messages to the admin if they are offensive.