Mention

To Mention user along with a message in a group, you can use mentionedUsersIds param provided to all kinds of messages such as Text, Image, video.

Text message

To send your text message, you need to pass the TextMessage object as an argument to the parameter in the sendTextMessage() method.

Java

TextMessage textMessage = new TextMessage();

textMessage.setToId(TO_JID);

textMessage.setMessageText(TEXT);

textMessage.setMentionedUsersIds(MENTION_IDS);

FlyMessenger.sendTextMessage(textMessage, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val textMessage = TextMessage().apply {

toId = TO_JID

messageText = TEXT

mentionedUsersIds = MENTION_IDS

}

FlyMessenger.sendTextMessage(textMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	TextMessage	Object to hold the parameters of the text message
CALLBACK	SendMessageCallback	callback to observe the action status

Image message

To send your image message, you need to pass the FileMessage object as an argument to the parameter in the sendFileMessage() method.

Java

FileMessageParams fileMessageParams = new FileMessageParams();

fileMessageParams.setFile(FILE);

fileMessageParams.setCaption(CAPTION);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.IMAGE);

fileMessage.setMentionedUsersIds(MENTION_IDS);

fileMessage.setFileMessage(fileMessageParams);

FlyMessenger.sendFileMessage(fileMessage, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val fileMessageParams = FileMessageParams().apply {

file = FILE

caption = CAPTION

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.IMAGE

mentionedUsersIds = MENTION_IDS

fileMessage = fileMessageParams

}

FlyMessenger.sendFileMessage(fileMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	FileMessage	Object to hold the parameters of the image message
CALLBACK	SendMessageCallback	callback to observe the action status

Note : In ChatManager .setMediaFolderName should be defined to set your own local path to store app media files.

caution

If Image attachment feature unavailable for your plan then it will throw 403 exception.

Image message with url

To send your image message, you need to pass the FileMessage object as an argument to the parameter in the sendFileMessage() method.

Java

FileMessageParams fileMessageParams = new FileMessageParams();

fileMessageParams.setFileUrl(FILE_URL);

fileMessageParams.setFileName(FILE_NAME);

fileMessageParams.setFileSize(FILE_SIZE);

fileMessageParams.setLocalFilePath(LOCAL_FILE_PATH);

fileMessageParams.setThumbImage(THUMB_IMAGE);

fileMessageParams.setCaption(CAPTION);

FileMessage sendMessageParams = new FileMessage();

sendMessageParams.setToId(TO_JID);

sendMessageParams.setMessageType(MessageType.IMAGE);

sendMessageParams.setMentionedUsersIds(MENTION_IDS);

sendMessageParams.setFileMessage(fileMessageParams);

FlyMessenger.sendFileMessage(sendMessageParams, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val fileMessageParams = FileMessageParams().apply {

fileUrl = FILE_URL

fileName = FILE_NAME

fileSize = FILE_SIZE

localFilePath = LOCAL_FILE_PATH

thumbImage = THUMB_IMAGE

caption = CAPTION

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.IMAGE

mentionedUsersIds = MENTION_IDS

fileMessage = fileMessageParams

}

FlyMessenger.sendFileMessage(fileMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	FileMessage	Object to hold the parameters of the image message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

If Image attachment feature unavailable for your plan then it will throw 403 exception.

Video message

To send your video message, you need to pass the FileMessage object as an argument to the parameter in the sendFileMessage() method.

Java

FileMessageParams fileMessageParams = new FileMessageParams();

fileMessageParams.setFile(FILE);

fileMessageParams.setCaption(CAPTION);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.VIDEO);

fileMessage.setMentionedUsersIds(MENTION_IDS);

fileMessage.setFileMessage(fileMessageParams);

FlyMessenger.sendFileMessage(fileMessage, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val fileMessageParams = FileMessageParams().apply {

file = FILE

caption = CAPTION

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.VIDEO

mentionedUsersIds = MENTION_IDS

fileMessage = fileMessageParams

}

FlyMessenger.sendFileMessage(fileMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	FileMessage	Object to hold the parameters of the video message
CALLBACK	SendMessageCallback	callback to observe the action status

Note : In ChatManager .setMediaFolderName should be defined to set your own local path to store app media files.

caution

If Video attachment feature unavailable for your plan then it will throw 403 exception.

Video message with url

To send your video message, you need to pass the FileMessage object as an argument to the parameter in the sendFileMessage() method.

Java

FileMessageParams fileMessageParams = new FileMessageParams();

fileMessageParams.setFileUrl(FILE_URL);

fileMessageParams.setFileName(FILE_NAME);

fileMessageParams.setFileSize(FILE_SIZE);

fileMessageParams.setLocalFilePath(LOCAL_FILE_PATH);

fileMessageParams.setThumbImage(THUMB_IMAGE);

fileMessageParams.setDuration(DURATION);

fileMessageParams.setCaption(CAPTION);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.VIDEO);

fileMessage.setMentionedUsersIds(MENTION_IDS);

fileMessage.setFileMessage(fileMessageParams);

FlyMessenger.sendFileMessage(fileMessage, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val fileMessageParams = FileMessageParams().apply {

fileUrl = FILE_URL

fileName = FILE_NAME

fileSize = FILE_SIZE

localFilePath = LOCAL_FILE_PATH

thumbImage = THUMB_IMAGE

duration = DURATION

caption = CAPTION

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.VIDEO

mentionedUsersIds = MENTION_IDS

fileMessage = fileMessageParams

}

FlyMessenger.sendFileMessage(fileMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	FileMessage	Object to hold the parameters of the video message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

If Video attachment feature unavailable for your plan then it will throw 403 exception.

Send Reply message

To send reply message to the original message, you need to pass the additional parameter original message-id in replyMessageId.TextMessage object as an argument to the parameter in the sendTextMessage() method.

Java

TextMessage textMessage = new TextMessage();

textMessage.setToId(TO_JID);

textMessage.setMessageText(TEXT);

textMessage.setReplyMessageId(REPLY_MESSAGE_ID);

textMessage.setMentionedUsersIds(MENTION_IDS);

FlyMessenger.sendTextMessage(textMessage, (isSuccess, error, chatMessage) -> {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

});

Kotlin

val textMessage = TextMessage().apply {

toId = TO_JID

messageText = TEXT

replyMessageId = REPLY_MESSAGE_ID

mentionedUsersIds = MENTION_IDS

}

FlyMessenger.sendTextMessage(textMessage, object : SendMessageCallback {

override fun onResponse(isSuccess: Boolean, error: Throwable?, chatMessage: ChatMessage?) {

if (isSuccess) {

//you can add this message object to your arraylist,

//then you can call notifyItemInserted in adapter of recycler view

}

}

})

Argument	Type	Description
MESSAGE_PARAMS	TextMessage	Object to hold the parameters of the text message
CALLBACK	SendMessageCallback	callback to observe the action status

Receive Message

To receive a mentioned related message from another user in a group, you must implement the messageListener function. It’s a function that will be triggered whenever you receive a new message or related event in the chat.

java

fun onMessageReceived(ChatMessage message) {

}

Kotlin

fun onMessageReceived(message : ChatMessage) {

}

info

To learn more on message listener callbacks, see the MessageEventsCallbacks.