Single chat module

Prerequisites

In order to send messages using the chat sdk , at first you need to establish the connection to the server. sdk provides methods for initializing the connection configuration as well as methods for making connection.

Note: Even if you don't have internet connection, you are still allowed to send messages which will be kept in offline database.Once the user connected to the internet, the messages will be sent automatically when user opens the app.

Preparing single chat jid

Almost of the sdk methods expect jid as a input parameter, so sdk provides below utility method to prepare the jid. The method prepares the single chat jid from the given string by using chat config provided via [com.contusflysdk.api.ChatConnectionManager.initialize] method.

Note: The below characters is not allowed in uniqueId: U+0022 (") U+0026 (&) U+0027 (') U+002F (/) U+003A (:) U+003C (<) U+003E (>) U+0040 (@).

Argument	Type	Description
UNIQUE_USER_ID	String	unique userId for preparing JID

Java

FlyUtils.getJid(UNIQUE_USER_ID)

Kotlin

FlyUtils.getJid(UNIQUE_USER_ID)

Text message

Text is a basic form of communication between users. sdk provides methods to send the text message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the text message for a user, you can utilise the below method.

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.setReplyMessageId(REPLY_MESSAGE_ID); // Optional

textMessage.setMentionedUsersIds(MENTION_IDS); // Optional

textMessage.setMetaData(META_DATA); //Optional

textMessage.setTopicId(TOPIC_ID); //Optional

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 // Optional

mentionedUsersIds = MENTION_IDS // Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

}

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

Location message

Location sharing is a famous communication between users. sdk provides methods to send the location message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the location message for a user, you can utilise the below method.

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

Java

LocationMessageParams locationMessageParams = new LocationMessageParams();

locationMessageParams.setLatitude(LATITUDE);

locationMessageParams.setLongitude(LONGITUDE);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.LOCATION);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setLocationMessage(locationMessageParams);

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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 locationMessageParams = LocationMessageParams().apply {

latitude = LATITUDE

longitude = LONGITUDE

}

val fileMessage = FileMessage().apply {

toId = TO_JID

replyMessageId = REPLY_MESSAGE_ID //Optional

messageType = MessageType.LOCATION

locationMessage = locationMessageParams

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

}

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 location message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

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

Contact message

Contact sharing is very useful communication between users. sdk provides methods to send the contact message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the contact message for a user, you can utilise the below method.

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

Java

ContactMessageParams contactMessageParam = new ContactMessageParams();

contactMessageParam.setName(CONTACT_NAME);

contactMessageParam.setNumbers(CONTACT_NUMBERS);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.CONTACT);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setContactMessage(contactMessageParam);

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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 contactMessageParams = ContactMessageParams().apply {

name = CONTACT_NAME

numbers = CONTACT_NUMBERS

}

val fileMessage = FileMessage().apply {

toId = TO_JID

replyMessageId = REPLY_MESSAGE_ID //Optional

messageType = MessageType.CONTACT

contactMessage = contactMessageParams

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

}

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 contact message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

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

Document message

Document sharing is very useful communication between users. sdk provides methods to send the document message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the document message for a user, you can utilise the below method.

To send your document 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);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.DOCUMENT);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setFileMessage(fileMessageParams);

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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

}

val fileMessage = FileMessage().apply {

toId = TO_JID

replyMessageId = REPLY_MESSAGE_ID //Optional

messageType = MessageType.DOCUMENT

fileMessage = fileMessageParams

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

}

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 document 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 Document attachment feature unavailable for your plan then it will throw 403 exception.

Document message with url

If you have uploaded the document to your own media server and the you want to share document with other user. sdk provides methods to send the document message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the document message for a user, you can utilise the below method.

To send your document 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);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.DOCUMENT);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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

}

val fileMessage = FileMessage().apply {

toId = TO_JID

replyMessageId = REPLY_MESSAGE_ID //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

messageType = MessageType.DOCUMENT

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 document message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

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

Video message

Video sharing is very useful communication between users. sdk provides methods to send the video message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the video message for a user, you can utilise the below method.

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.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMentionedUsersIds(MENTION_IDS); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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 //Optional

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.VIDEO

replyMessageId = REPLY_MESSAGE_ID //Optional

mentionedUsersIds = MENTION_IDS //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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

If you have uploaded the video to your own media server and the you want to share video with other user. sdk provides methods to send the video message to the end users. once the user has sent message via sdk, it will give callback with status. if you want send the video message for a user, you can utilise the below method.

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); //Optional

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.VIDEO);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMentionedUsersIds(MENTION_IDS); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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 //Optional

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.VIDEO

replyMessageId = REPLY_MESSAGE_ID //Optional

mentionedUsersIds = MENTION_IDS //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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.

Image message

To send image as a message call the below method. Calling the below method will upload the image file to the server provided during sdk initialization then send the 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); //Optional

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.IMAGE);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMentionedUsersIds(MENTION_IDS); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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 //Optional

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.IMAGE

replyMessageId = REPLY_MESSAGE_ID //Optional

mentionedUsersIds = MENTION_IDS //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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 image as a message call the below method. You can upload the image file to your storage of choice and send the url and other necessary info while sending the 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.setFileUrl(FILE_URL);

fileMessageParams.setFileName(FILE_NAME);

fileMessageParams.setFileSize(FILE_SIZE);

fileMessageParams.setLocalFilePath(LOCAL_FILE_PATH);

fileMessageParams.setThumbImage(THUMB_IMAGE);

fileMessageParams.setCaption(CAPTION); //Optional

FileMessage sendMessageParams = new FileMessage();

sendMessageParams.setToId(TO_JID);

sendMessageParams.setMessageType(MessageType.IMAGE);

sendMessageParams.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

sendMessageParams.setMentionedUsersIds(MENTION_IDS); //Optional

sendMessageParams.setMetaData(META_DATA); //Optional

sendMessageParams.setTopicId(TOPIC_ID); //Optional

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 //Optional

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.IMAGE

replyMessageId = REPLY_MESSAGE_ID //Optional

mentionedUsersIds = MENTION_IDS //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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.

Audio message

To send audio as a message call the below method. Calling the below method will upload the audio file to the server provided during sdk initialization then send the message

To send your audio 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);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.AUDIO or MessageType.AUDIO_RECORDED);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.AUDIO or MessageType.AUDIO_RECORDED

replyMessageId = REPLY_MESSAGE_ID //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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 audio 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 Audio attachment feature unavailable for your plan then it will throw 403 exception.

Audio message with url

To send audio as a message call the below method. You can upload the audio file to your storage of choice and send the url and other necessary info while sending the message.

To send your audio 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.setFileSize(FILE_SIZE);

fileMessageParams.setLocalFilePath(LOCAL_FILE_PATH);

fileMessageParams.setDuration(DURATION);

FileMessage fileMessage = new FileMessage();

fileMessage.setToId(TO_JID);

fileMessage.setMessageType(MessageType.AUDIO or MessageType.AUDIO_RECORDED);

fileMessage.setReplyMessageId(REPLY_MESSAGE_ID); //Optional

fileMessage.setMetaData(META_DATA); //Optional

fileMessage.setTopicId(TOPIC_ID); //Optional

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

fileSize = FILE_SIZE

localFilePath = LOCAL_FILE_PATH

duration = DURATION

}

val fileMessage = FileMessage().apply {

toId = TO_JID

messageType = MessageType.AUDIO or MessageType.AUDIO_RECORDED

replyMessageId = REPLY_MESSAGE_ID //Optional

metaData = META_DATA // Optional

topicId = TOPIC_ID// optional

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 audio message
CALLBACK	SendMessageCallback	callback to observe the action status

caution

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

Get media messages

If you want to get the media messages for a user/group, you can utilise the below method.

Java

List<ChatMessage> mediaMessages = ChatManager.getMediaMessages(JID);

Kotlin

val mediaMessages : List<ChatMessage> = ChatManager.getMediaMessages(JID)

Argument	Type	Description
JID	String	jid of the chat user

info

Above methods fetch media messages which are successfully sent and received.

caution

If media message feature unavailable for your plan then it will throw 403 exception.

To get the uploaded/downloaded status of a media message Refer the snippet below.

For received media message:

Java

ChatMessage message = FlyMessenger.getMessageOfId(MEDIA_MESSAGE_ID);

MediaChatMessage mediaMessage = message.getMediaChatMessage();

@MediaDownloadStatus int mediaStatus = mediaMessage.getMediaDownloadStatus();

//The possible values of mediaStatus were

MediaDownloadStatus.MEDIA_DOWNLOADING

MediaDownloadStatus.MEDIA_DOWNLOADED

MediaDownloadStatus.MEDIA_NOT_DOWNLOADED

MediaDownloadStatus.MEDIA_DOWNLOADED_NOT_AVAILABLE

Kotlin

val message = FlyMessenger.getMessageOfId(MEDIA_MESSAGE_ID)

val mediaMessage = message?.getMediaChatMessage()

val mediaStatus = mediaMessage?.getMediaDownloadStatus()

//The possible values of mediaStatus were

MediaDownloadStatus.MEDIA_DOWNLOADING

MediaDownloadStatus.MEDIA_DOWNLOADED

MediaDownloadStatus.MEDIA_NOT_DOWNLOADED

MediaDownloadStatus.MEDIA_DOWNLOADED_NOT_AVAILABLE

For sent media message:

Java

ChatMessage message = FlyMessenger.getMessageOfId(MEDIA_MESSAGE_ID);

MediaChatMessage mediaMessage = message.getMediaChatMessage();

@MediaUploadStatus int mediaStatus = mediaMessage.getMediaUploadStatus();

//The possible values of mediaStatus were

MediaUploadStatus.MEDIA_NOT_UPLOADED

MediaUploadStatus.MEDIA_UPLOADING

MediaUploadStatus.MEDIA_UPLOADED

MediaUploadStatus.MEDIA_UPLOADED_NOT_AVAILABLE

Kotlin

val message = FlyMessenger.getMessageOfId(MEDIA_MESSAGE_ID)

val mediaMessage = message?.getMediaChatMessage()

val mediaStatus = mediaMessage?.getMediaUploadStatus()

//The possible values of mediaStatus were

MediaUploadStatus.MEDIA_NOT_UPLOADED

MediaUploadStatus.MEDIA_UPLOADING

MediaUploadStatus.MEDIA_UPLOADED

MediaUploadStatus.MEDIA_UPLOADED_NOT_AVAILABLE

Argument	Type	Description
MEDIA_MESSAGE_ID	String	id of a message

Delete Messages

Delete messsage is a feature which is found in modern messaging apps which allows the user to delete the message once it is sent.Once you sent the message, you can able to delete the messages by using built in sdk methods.

Delete for me

If you want to delete the messages for yourself only then you can use the below method.

Note: The messages will not be deleted to the receipient.

Argument	Type	Description
TO_JID	String	jid of the chat user
MESSAGE_ID_LIST	List<String>	List of messageId to be deleted
DELETE_CHAT_TYPE	DeleteChatType	DeleteChatType.chat for single chat, DeleteChatType.groupchat for group chat
IS_MEDIA_DELETE	boolean	true, if media file also to be deleted in the local storage
CALLBACK	ChatActionListener	callback to observe the action status

Java

ChatManager.deleteMessagesForMe(TO_JID, MESSAGE_ID_LIST, DELETE_CHAT_TYPE, IS_MEDIA_DELETE, (isSuccess, message) -> {

});

Kotlin

ChatManager.deleteMessagesForMe(TO_JID, MESSAGE_ID_LIST, DELETE_CHAT_TYPE, IS_MEDIA_DELETE, object : ChatActionListener {

override fun onResponse(isSuccess: Boolean, message: String) {

}

})

Delete for everyone

If you want to delete the messages for yourself and receiver then you can use the below method. The messages will also be deleted to the receipient.

Argument	Type	Description
TO_JID	String	jid of the chat user
MESSAGE_ID_LIST	List<String>	List of messageId to be deleted
DELETE_CHAT_TYPE	DeleteChatType	DeleteChatType.chat for single chat, DeleteChatType.groupchat for group chat
IS_MEDIA_DELETE	boolean	true, if media file also to be deleted in the local storage
CALLBACK	ChatActionListener	callback to observe the action status

Java

ChatManager.deleteMessagesForEveryone(TO_JID, MESSAGE_ID_LIST, DELETE_CHAT_TYPE, IS_MEDIA_DELETE, (isSuccess, message) -> {

});

Kotlin

ChatManager.deleteMessagesForEveryone(TO_JID, MESSAGE_ID_LIST, DELETE_CHAT_TYPE, IS_MEDIA_DELETE, object : ChatActionListener {

override fun onResponse(isSuccess: Boolean, message: String) {

}

})

caution

If delete message feature unavailable for your plan then it will throw 403 exception.

Favourite Messages

Favourite messags is feature which allows users to mark some messages as favourites. so that they can see those important messages in future without searching for them in chat. Once you marked messages as favourite, you can get those from sdk to show it in your app's screen.

Argument	Type	Description
MESSAGE_ID	String	messageId of the message
CHAT_USER_JID	String	jid of the chat user
IS_FAVOURITE	boolean	true, if you are adding to favourites.false to remove from favourites
CALLBACK	ChatActionListener	callback to observe the action status

Make favourite

You can mark the messages as favourite by using the below method.

Java

ChatManager.updateFavouriteStatus(MESSAGE_ID, CHAT_USER_JID, true, (isSuccess, message) -> {

});

Kotlin

ChatManager.updateFavouriteStatus(MESSAGE_ID, CHAT_USER_JID, true, object : ChatActionListener {

override fun onResponse(isSuccess: Boolean, message: String) {

}

})

Remove favourite

You can remove the messages from favourite by using the below method.

Java

ChatManager.updateFavouriteStatus(MESSAGE_ID, CHAT_USER_JID, false, (isSuccess, message) -> {

});

Kotlin

ChatManager.updateFavouriteStatus(MESSAGE_ID, CHAT_USER_JID, false, object : ChatActionListener {

override fun onResponse(isSuccess: Boolean, message: String) {

}

})

Get all favourite messages

The below method will return all the favourite messages from the local db.

Java

List<ChatMessage> favouriteMessages = FlyMessenger.getFavouriteMessages();

Kotlin

val favouriteMessages : List<ChatMessage> = FlyMessenger.getFavouriteMessages()

Unfavorite all the favourite messages

You can unfavourite all the favourite messages by using the below method.

Java

ChatManager.unFavouriteAllFavouriteMessages((isSuccess, message) -> {

if(isSuccess){

//Unfavourite success update the UI

}else{

// Unfavourite failed print message to know the error

}

})

Kotlin

ChatManager.unFavouriteAllFavouriteMessages(object : ChatActionListener {

override fun onResponse(isSuccess: Boolean, message: String) {

if(isSuccess){

//Unfavourite success update the UI

}else{

// Unfavourite failed print message to know the error

}

}

})

caution

If favourite message feature unavailable for your plan then it will throw 403 exception.

Message receipts

info

To obserserve message's sent, delivered, read status refer the message callback listeners.

Message receipts is a feature which allows users to know the status of the sent messages as well as the delivered and read time for the messages. The chat app users are well informed about the status of the sent messages.

You need to update the ongoing chat user jid always whenever you are entering/exiting the chat window of user by using below method. it is used by sdk internally for receipts.

In activity/fragment onResume, set the user jid as ongoing chat user.

Argument	Type	Description
JID	String	jid of the chat user

Java

@Override

public void onResume() {

super.onResume();

ChatManager.setOnGoingChatUser(JID);

}

Kotlin

override fun onResume() {

super.onResume()

ChatManager.setOnGoingChatUser(JID)

...

}

Then, in activity/fragment onPause, clear the ongoing chat user.

Java

@Override

public void onPause() {

super.onPause();

ChatManager.setOnGoingChatUser("");

}

Kotlin

override fun onPause() {

super.onPause()

ChatManager.setOnGoingChatUser("")

...

}

Mark messages as delivered

You don't need to send the delivery receipts explicitly, it will be automatically sent by the sdk.

Mark messages as read

Once the user reads the messages of user B or entered into the chat window of user B, you can mark the messages as read by using the below method. In this case user B's jid will be passed to the below method. Then read receipts will be managed by sdk. sdk will utilise the ongoing chat user jid which is set by this method ChatManager.setOnGoingChatUser(jid: String)

Argument	Type	Description
JID	String	jid of the chat user

Java

ChatManager.markAsRead(JID);

Kotlin

ChatManager.markAsRead(JID)

info

Sdk is having a built-in functions to prepare the JID, Group JID.

Get single chat message status

To get the time of sent, delivered and seen status of a message sent by you in a single one to one chat call the below method.

Java

ChatMessageStatusDetail messageStatus = FlyMessenger.getMessageStatusOfASingleChatMessage(MESSAGE_ID);

Kotlin

val messageStatus: ChatMessageStatusDetail = FlyMessenger.getMessageStatusOfASingleChatMessage(MESSAGE_ID)

Argument	Type	Description
MESSAGE_ID	String	message id of the message

Get messages of a user/group by pagination

####Initialization First, create a FetchMessageListParams instance. Here, you need to set the message filter to determine the message order and the starting point of the message list in the chat view.

Java

FetchMessageListParams messageListParams = new FetchMessageListParams();

messageListParams.setChatJid(JID);

messageListParams.setMessageId(MESSAGE_ID);

messageListParams.setMessageTime(MESSAGE_TIME);

messageListParams.setInclusive(true);

messageListParams.setAscendingOrder(true);

messageListParams.setLimit(50);

messageListParams.setMetaData(META_DATA);//Optional

messageListParams.setTopicId(TOPIC_ID); //Optional

Kotlin

val messageListParams = FetchMessageListParams().apply {

chatJid = JID

messageId = MESSAGE_ID

messageTime = MESSAGE_TIME

inclusive = true

ascendingOrder = true

limit = 50

metaData = META_DATA //Optional

topicId = TOPIC_ID// optional

}

Argument	Type	Description
JID	String	Jid of the user/group
MESSAGE_ID	String	Message id of the starting point optional
MESSAGE_TIME	String	Message time of the starting point optional
INCLUSIVE	boolean	If true starting point message will included in message list default false
ASCENDING_ORDER	boolean	If true message list will be returned ascendingOrder by message time default false
LIMIT	int	No of messages will be fetched for each request default 50
META_DATA	MetaDataMessageList	metadata of the Messages optional
TOPIC_ID	String	Topic ID to be sent

Second, create a FetchMessageListQuery instance.

Java

FetchMessageListQuery messageListQuery = new FetchMessageListQuery(MESSAGE_LIST_PARAM);

Kotlin

val messageListQuery = FetchMessageListQuery(MESSAGE_LIST_PARAM)

Argument	Type	Description
MESSAGE_LIST_PARAM	FetchMessageListParams	Insatance of 'FetchMessageListParams'

Load Initial Messages

To fetch initial conversations between you and a single chat user or group, call the below method.

Java

messageListQuery.loadMessages((isSuccess, throwable, data) -> {

if (isSuccess) {

List<ChatMessage> messageList = (List<ChatMessage>) data.get("data");

} else {

// Fetch messages failed print throwable to find the exception details.

}

});

Kotlin

messageListQuery.loadMessages { isSuccess, throwable, data ->

if (isSuccess) {

val messageList = data["data"] as ArrayList<ChatMessage>

} else {

// Fetch messages failed print throwable to find the exception details.

}

}

Argument	Type	Description
CALLBACK	FlyCallback	'FlyCallback' implemented as lambda expression

Load Previous Messages

To fetch previous conversations between you and a single chat user or group, call the below method.

Java

messageListQuery.loadPreviousMessages((isSuccess, throwable, data) -> {

if (isSuccess) {

List<ChatMessage> messageList = (List<ChatMessage>) data.get("data");

} else {

// Fetch messages failed print throwable to find the exception details.

}

});

Kotlin

messageListQuery.loadPreviousMessages { isSuccess, throwable, data ->

if (isSuccess) {

val messageList = data["data"] as ArrayList<ChatMessage>

} else {

// Fetch messages failed print throwable to find the exception details.

}

}

Argument	Type	Description
CALLBACK	FlyCallback	'FlyCallback' implemented as lambda expression

Load Next Messages

To fetch next conversations between you and a single chat user or group, call the below method.

Java

messageListQuery.loadNextMessages((isSuccess, throwable, data) -> {

if (isSuccess) {

List<ChatMessage> messageList = (List<ChatMessage>) data.get("data");

} else {

// Fetch messages failed print throwable to find the exception details.

}

});

Kotlin

messageListQuery.loadNextMessages { isSuccess, throwable, data ->

if (isSuccess) {

val messageList = data["data"] as ArrayList<ChatMessage>

} else {

// Fetch messages failed print throwable to find the exception details.

}

}

Argument	Type	Description
CALLBACK	FlyCallback	'FlyCallback' implemented as lambda expression

Check Previous Set of Messages Available or not

To check previous set of conversations available or not, call the below method.

Java

Boolean hasPreviousMessages = messageListQuery.hasPreviousMessages();

Kotlin

val hasPreviousMessages = messageListQuery.hasPreviousMessages()

Check Next Set of Messages Available

To check next set of conversations available or not, call the below method.

Java

Boolean hasNextMessages = messageListQuery.hasNextMessages();

Kotlin

val hasNextMessages = messageListQuery.hasNextMessages()

Check Message Fetching InProgress

To check conversations fetching in progress or not, call the below method.

Java

Boolean fetchingInProgress = messageListQuery.isFetchingInProgress();

Kotlin

val fetchingInProgress = messageListQuery.isFetchingInProgress()

Get messages of a user/group

To fetch all the conversation between you and a single chat user or group, call the below method.

Java

List<ChatMessage> messages = FlyMessenger.getMessagesOfJid(JID);

Kotlin

val messages : List<ChatMessage> = FlyMessenger.getMessagesOfJid(JID)

Argument	Type	Description
JID	String	Jid of the user/group

warning

Above method getting messages from Local DB, If you have chat history feature use loadMessages()

Get message from db

Whenever you get callbacks from MessageEventsListener, you will get messageId sometimes at those times you can fetch the message from db using the below method and then update your list as well as notify the list view.

Java

ChatMessage message = FlyMessenger.getMessageOfId(MESSAGE_ID);

Kotlin

val message : ChatMessage? = FlyMessenger.getMessageOfId(MESSAGE_ID)

Argument	Type	Description
MESSAGE_ID	String	messageId of the message

Get messages using id

To get list of messages from a given message id's call the below method.

Java

List<ChatMessage> messages = FlyMessenger.getMessagesUsingIds(MESSAGE_ID_LIST);

Kotlin

val messages : List<ChatMessage> = FlyMessenger.getMessagesUsingIds(MESSAGE_ID_LIST)

Remove unread message separator

To remove the unread message separator in a chat conversation list call the below method.

Java

FlyMessenger.deleteUnreadMessageSeparatorOfAConversation(JID);

Kotlin

FlyMessenger.deleteUnreadMessageSeparatorOfAConversation(JID)

Argument	Type	Description
JID	String	Jid of the user/group

Get recalled messages of a user/group

To get the recalled messages of a user/group call the below method.

Java

List<ChatMessage> recalledMessages = FlyMessenger.getRecalledMessagesOfAConversation(JID);

Kotlin

val recalledMessages : List<ChatMessage> = FlyMessenger.getRecalledMessagesOfAConversation(JID)

Argument	Type	Description
JID	String	Jid of the user/group

Upload/Download media message

Whenever you receive a media message from a user, or when retrying to upload a already sent media message you can use built-in sdk functions to upload/download the media content / The below method is applicable only if you are using sdk media server, otherwise you have to handle uploading/downloading the media by your own implementation as well as update the status of the media message.

Java

FlyMessenger.uploadMedia(MEDIA_MESSAGE_ID);

FlyMessenger.downloadMedia(MEDIA_MESSAGE_ID);

Kotlin

FlyMessenger.uploadMedia(MEDIA_MESSAGE_ID)

FlyMessenger.downloadMedia(MEDIA_MESSAGE_ID)

Argument	Type	Description
MEDIA_MESSAGE_ID	String	Id of the media message

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

Update media status

Update media download status

If you are using your own media service, whenever the media downloading status is changed, you have to update the media message status like below.

Java

FlyMessenger.updateMediaDownloadStatus(MEDIA_MESSAGE_ID,PROGRESS_STATUS,DATA_TRANSFERRED,DOWNLOAD_STATUS);

Kotlin

FlyMessenger.updateMediaDownloadStatus(MEDIA_MESSAGE_ID,PROGRESS_STATUS,DATA_TRANSFERRED,DOWNLOAD_STATUS)

Argument	Type	Description
MEDIA_MESSAGE_ID	String	id of the media message
PROGRESS_STATUS	int	percentage of the file downloaded till now (0-100)
DATA_TRANSFERRED	long	size of the file downloaded till now
DOWNLOAD_STATUS	MediaDownloadStatus	status of the upload

status value could be one of the values below:

Java

MediaDownloadStatus.MEDIA_DOWNLOADING

MediaDownloadStatus.MEDIA_DOWNLOADED

MediaDownloadStatus.MEDIA_NOT_DOWNLOADED

MediaDownloadStatus.MEDIA_DOWNLOADED_NOT_AVAILABLE;

Kotlin

MediaDownloadStatus.MEDIA_DOWNLOADING

MediaDownloadStatus.MEDIA_DOWNLOADED

MediaDownloadStatus.MEDIA_NOT_DOWNLOADED

MediaDownloadStatus.MEDIA_DOWNLOADED_NOT_AVAILABLE;

Update media upload status

If you are using your own media service, whenever the media uploading status is changed, you have to update the media message status like below.

Java

FlyMessenger.updateMediaUploadStatus(MEDIA_MESSAGE_ID,PROGRESS_STATUS,DATA_TRANSFERRED,UPLOAD_STATUS);

Kotlin

FlyMessenger.updateMediaUploadStatus(MEDIA_MESSAGE_ID,PROGRESS_STATUS,DATA_TRANSFERRED,UPLOAD_STATUS)

Argument	Type	Description
MEDIA_MESSAGE_ID	String	id of the media message
PROGRESS_STATUS	int	percentage of the file uploaded till now (0-100)
DATA_TRANSFERRED	long	size of the file uploaded till now
UPLOAD_STATUS	MediaUploadStatus	status of the upload

status value could be one of the values below:

Java

MediaUploadStatus.MEDIA_NOT_UPLOADED

MediaUploadStatus.MEDIA_UPLOADING

MediaUploadStatus.MEDIA_UPLOADED

MediaUploadStatus.MEDIA_UPLOADED_NOT_AVAILABLE

Kotlin

MediaUploadStatus.MEDIA_NOT_UPLOADED

MediaUploadStatus.MEDIA_UPLOADING

MediaUploadStatus.MEDIA_UPLOADED

MediaUploadStatus.MEDIA_UPLOADED_NOT_AVAILABLE

Cancel upload/download

Whenever you would like to cancel upload/download of a media message , you can use built-in sdk functions to cancel the media content upload/download.The below method is applicable only if you are using sdk media server, otherwise you have to handle cancelling the media by your own implementation as well as update the status of the media message.

Argument	Type	Description
MESSAGE_ID	String	message id of the media message

Java

FlyMessenger.cancelMediaUploadOrDownload(MESSAGE_ID);

Kotlin

FlyMessenger.cancelMediaUploadOrDownload(MESSAGE_ID)

When the user cancelled the media download, then user need to restart the download using FlyMessenger.downloadMedia(messageId: String) method. In case of media upload, the upload initiated once the user sent the message In case of retry call FlyMessenger.uploadMedia(messageId: String).

info

Sdk is having a built-in functions to prepare the JID, Group JID.

Upload/Download push notification tap action

Whenever you would like to add tap action for Upload/Download push notification, you can use built-in sdk functions to add action listener to upload/download push notification. The below method is applicable only if you are using sdk media server, otherwise you have to handle tap action by your own implementation.

In your application class oncreate method add the below method:

Java

ChatManager.setMediaNotificationHelper((notificationCompatBuilder, toUsers) -> {

// Add your setContentIntent to notificationCompatBuilder here by using jidList which has uploading/downloading media files

});

Kotlin

ChatManager.setMediaNotificationHelper(object : MediaNotificationHelper {

override fun setMediaNotificationIntentAction(

notificationCompatBuilder: NotificationCompat.Builder,

jidList: List<String>

) {

// Add your setContentIntent to notificationCompatBuilder here by using jidList which has uploading/downloading media files

}

})

Encrypt/Decrypt media files

To encrypt all media files while uploading to server, call below method to enable media encryption in SDK

Java

ChatManager.setMediaEncryption(true);

Kotlin

ChatManager.setMediaEncryption(true)

Note: If this flag enabled then all type of media files will be encrypted while uploading and stored in server, On receiver side media files will be decrypted while downloading and readable file will be stored in local storage.

Delete all messages in local db

To delete all the chat conversation messages and their relevent data like message statuses call the below method.

Java

FlyMessenger.deleteAllMessages();

Kotlin

FlyMessenger.deleteAllMessages()

caution

If delete message feature unavailable for your plan then it will throw 403 exception.