Skip to main content
Version: v4

Mentions

Mentions​

Mentions are a powerful tool for enhancing communication in messaging platforms. They streamline interaction by allowing users to easily engage and collaborate with particular individuals, especially in group conversations.

Mentions in messages enable users to refer to specific individuals within a conversation.

Send Mentioned Messages​

Every User object has a String unique identifier associated with them which can be found in a property called uid. To mention a user in a message, the message text should contain the uid in following format: <@uid:UID_OF_THE_USER>. For example, to mention the user with UID cometchat-uid-1 in a text message, your text should be "<@uid:cometchat-uid-1>"

private String receiverID = "UID";
private String messageText = "Hello, <@uid:cometchat-uid-1>";
private String receiverType = CometChatConstants.RECEIVER_TYPE_USER;

TextMessage textMessage = new TextMessage(receiverID, messageText, receiverType);

CometChat.sendMessage(textMessage, new CometChat.CallbackListener<TextMessage>() {
  @Override
  public void onSuccess(TextMessage textMessage) {
      Log.d(TAG, "Message sent successfully: " + textMessage.toString());
  }

  @Override
  public void onError(CometChatException e) {
      Log.d(TAG, "Message sending failed with exception: " + e.getMessage());
  }
});
note

You can mention user in text message and media messages captions

Mentioned Messages​

By default, the SDK will fetch all the messages irrespective of the fact that the logged-in user is mentioned or not in the message.

The SDK allows you to fetch messages in a conversation where the logged-in user is mentioned. The SDK also has other optional filters such as tag info and blocked info.

SettingDescription
myMentionsOnly(boolean value) If set to true, SDK will fetch a list of messages where the logged-in user is mentioned.
Default value = false
mentionsWithTagInfo(boolean value)If set to true, SDK will fetch a list of messages where users are mentioned & will also fetch the tags of the mentioned users.
Default value = false
mentionsWithBlockedInfo(boolean value)If set to true, SDK will fetch a list of messages where users are mentioned & will also fetch their blocked relationship with the logged-in user.
Default value = false

My Mentions Only​

To get a list of messages in a conversation where the logged-in user is mentioned.

String UID = "cometchat-uid-1";

MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
.setLimit(50)
.setUID(UID)
.myMentionsOnly(true)
.build();

messagesRequest.fetchPrevious(new CometChat.CallbackListener<List<BaseMessage>>() {
  @Override
  public void onSuccess(List<BaseMessage> messages) {
    for (BaseMessage messageObj: messages){
      for (User user: messageObj.getMentionedUsers()){
        Log.e(TAG, "user: " + user.toString());
      }
    }
  }

  @Override
  public void onError(CometChatException e) {
    Log.e(TAG, "onError: " + e);
  }
});

Mentions With Tag Info​

To get a list of messages in a conversation where users are mentioned along with the user tags of the mentioned users.

String UID = "cometchat-uid-1";

MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
.setLimit(50)
.setUID(UID)
.mentionsWithTagInfo(true)
.build();

messagesRequest.fetchPrevious(new CometChat.CallbackListener<List<BaseMessage>>() {
  @Override
  public void onSuccess(List<BaseMessage> messages) {
    for (BaseMessage messageObj: messages){
      for (User user: messageObj.getMentionedUsers()){
        Log.e(TAG, "tag: " + user.getTags());
      }
    }
  }

  @Override
  public void onError(CometChatException e) {
    Log.e(TAG, "onError: " + e);
  }
});

Mentions With Blocked Info​

To get a list of messages in a conversation where users are mentioned along with the blocked relationship of the mentioned users with the logged-in user.

String UID = "cometchat-uid-1";

MessagesRequest messagesRequest = new MessagesRequest.MessagesRequestBuilder()
.setLimit(50)
.setUID(UID)
.mentionsWithBlockedInfo(true)
.build();

messagesRequest.fetchPrevious(new CometChat.CallbackListener<List<BaseMessage>>() {
  @Override
  public void onSuccess(List<BaseMessage> messages) {
    for (BaseMessage messageObj: messages){
      for (User user: messageObj.getMentionedUsers()){
        Log.e(TAG, "isBlockedByMe: " + user.isBlockedByMe());
        Log.e(TAG, "isHasBlockedMe: " + user.isHasBlockedMe());
      }
    }
  }

  @Override
  public void onError(CometChatException e) {
    Log.e(TAG, "onError: " + e);
  }
});

Get Users Mentioned In a Particular Message​

To retrieve the list of users mentioned in the particular message, you can use the message.getMentionedUsers() method. This method will return an array containing the mentioned users, or an empty array if no users were mentioned in the message.

message.getMentionedUsers()

Check if Logged-in user has been mentioned​

To check if the logged-in user has been mentioned in a particular message we can use the hasMentionedMe() method on any BaseMessage. This method will return a boolean value, true if the logged-in user has been mentioned, otherwise false.

message.hasMentionedMe()