/ SDKs / JavaScript
SDKs
Chat SDKs JavaScript v4
Chat SDKs JavaScript
Chat SDKs
JavaScript
Version 4

Receive messages in a group channel

Copy link

Messages sent by other group channel members can be received through the onMessagesAdded() method in message collection handler.


Message type

Copy link

Each BaseMessage object received in a group channel falls into one of the following three message types.

Message typeClassDescription

Text

UserMessage

A text message sent by a user.

File

FileMessage

A binary file message sent by a user.

File

MultipleFileMessage

A message with multiple files sent by a user.

Admin

AdminMessage

A text message sent by an admin through the Chat API.

File message and multiple files message

Copy link

When receiving a message payload with file data, the SDK can distinguish FileMessage and MultipleFilesMessages based on the number of files included in files. If the message contains more than two files, the SDK acknowledges it as a multipleFilesMessage. If the number of files contained in a messages exceeds the limit, which is 30, the message fails and returns an error of 800110. If any of the files exceeds the file size limit, it returns 800260.


Event handler

Copy link

When a new message arrives in a group channel, onMessageAdded() and onChannelUpdated() in the message collection are called.

Whenever an event related to message or group channel occurs, the collection is informed of the event through MessageContext and GroupChannelContext, respectively. The MessageContext and GroupChannelContext instances have CollectionEventSource, which contains the information of the event that took place. For example, when a new message is received, MessageEventSource.EVENT_MESSAGE_RECEIVED is passed as the MessageEventContext.source value to onMessagesAdded(). Meanwhile, when a message is delivered to group channel members who are online, the message's delivery status is automatically marked as delivered. The value for GroupChannelEventContext.source is set to GroupChannelEventSource.EVENT_CHANNEL_DELIVERED and channel members are notified of the event through onChannelUpdated(). To learn more about this topic, see the Message events section in the Message collection page.

You can also register other message-related event handlers using the addGroupChannelHandler() method in MessageCollectionEventHandler.

JavaScriptTypeScript
const eventHandler = {
  onChannelUpdated: (context, channel) => {
    // ...
  },
  onChannelDeleted: (context, channelUrl) => {
    // ...
  },
  onMessagesAdded: (context, channel, messages) => {
    // ...
  },
  onMessagesUpdated: (context, channel, messages) => {
    // ...
  },
  // As messageIds was deprecated since v4.3.1., use messages instead.
  onMessagesDeleted: (context, channel, messageIds, messages) => {
        // ...
  },
  onHugeGapDetected: () => {
    // ...
  },
};
messageCollection.setMessageCollectionHandler(eventHandler);

When the message UI is no longer needed, call dispose(). Note that the handlers don't work when the message collection is disposed.

JavaScriptTypeScript
messageCollection.dispose();