Mention other users in a message

In both group channels and open channels, a user can mention other users in a message to call their attention. Users have the option of calling specific users in the channel by their user IDs or calling all users in the channel.

Up to ten mentioned users are notified when mentioned. Notification preferences for mentions can be configured for each user in a channel.

To mention specific users when sending a message, add a list of user IDs to mentionedUserIds. Then, add the list to UserMessageCreateParams, FileMessageCreateParams, or MultipleFilesMessageCreateParams and pass the params to sendUserMessage(params:completionHandler:), sendFileMessage(params:completionHandler:), or sendMultipleFilesMessage(), respectively.

Mentioned users must belong to the channel where the message is being sent. Users who are mentioned but don't belong to the channel won't be included in the mentioned user IDs array of the sent message.

var userIdsToMention: [String] = []
userIdsToMention.append("Harry")
userIdsToMention.append("Jay")
userIdsToMention.append("Jin")

let params = UserMessageCreateParams(message: MESSAGE)
params.mentionedUserIds = userIdsToMention
params.mentionType = .users

channel.sendUserMessage(params: params) { userMessage, error in
    guard error == nil else {
        // Handle error.
        return
    }
}

When a user types "@channel" or other designated text in a message, you can set mentionType to .channel and let the user call the attention of everyone in the channel.

let params = UserMessageCreateParams(message: MESSAGE)
params.mentionType = .channel

channel.sendUserMessage(params: params) { userMessage, error in
    guard error == nil else {
        // Handle error.
        return
    }
}

Using channel mention is subject to the following limitations.