Send A Message - CometChat Docs

AI Integration Quick Reference

Field	Value
Package	`@cometchat/chat-sdk-javascript`
Import	`import { CometChat } from "@cometchat/chat-sdk-javascript";`
Key methods	`CometChat.sendMessage(textMessage)` · `CometChat.sendMediaMessage(mediaMessage)` · `CometChat.sendCustomMessage(customMessage)`
Message classes	`CometChat.TextMessage`, `CometChat.MediaMessage`, `CometChat.CustomMessage` (use `CometChat.Attachment` for hosted-URL media)
Primary output	`Promise<CometChat.BaseMessage>` — resolves to the sent `TextMessage` / `MediaMessage` / `CustomMessage`; rejects with `CometChat.CometChatException`
Receiver targeting	`receiverType`: `CometChat.RECEIVER_TYPE.USER` (pass a UID) or `CometChat.RECEIVER_TYPE.GROUP` (pass a GUID)
Prerequisites	SDK initialized via `CometChat.init()` and a logged-in user via `CometChat.login()`
Constraints	Card messages are receive-only (no `sendCardMessage()`). Media messages carry ≤ `file.count.max` attachments (default 10) or reject with `ERR_FILE_COUNT_EXCEEDED`; read the limit at runtime with `CometChat.getMaxAttachmentCount()`
Receive counterpart	Sent messages reach peers through `MessageListener` — see Receive a Message
Related	Upload Files · Threaded Messages · Edit a Message · Delete a Message
Full reference	`TextMessage` · `MediaMessage` · `CustomMessage`

Using CometChat, you can send three types of messages:

Text Message is the most common and standard message type.
Media Message for sending photos, videos and files.
Custom Message, for sending completely custom data using JSON structures.
Interactive Messages, for sending end-user interactive messages of type form, card and custom Interactive

You can also send metadata along with a text, media or custom message. Think, for example, if you’d want to share the user’s location with every message, you can use the metadata field

Text Message

Send a text message using CometChat.sendMessage() with a TextMessage object.

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  messageText: string = "Hello world!",
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  textMessage: CometChat.TextMessage = new CometChat.TextMessage(
    receiverID,
    messageText,
    receiverType
  );

CometChat.sendMessage(textMessage).then(
(message: CometChat.TextMessage) => {
console.log("Message sent successfully:", message);
},
(error: CometChat.CometChatException) => {
console.log("Message sending failed with error:", error);
}
);

let receiverID = "UID";
let messageText = "Hello world!";
let receiverType = CometChat.RECEIVER_TYPE.USER;
let textMessage = new CometChat.TextMessage(
  receiverID,
  messageText,
  receiverType
);

CometChat.sendMessage(textMessage).then(
  (message) => {
    console.log("Message sent successfully:", message);
  },
  (error) => {
    console.log("Message sending failed with error:", error);
  }
);

Alternatively, you can use the async/await syntax:

try {
  const receiverID = "UID";
  const messageText = "Hello world!";
  const receiverType = CometChat.RECEIVER_TYPE.USER;
  const textMessage = new CometChat.TextMessage(
    receiverID,
    messageText,
    receiverType
  );

  const message = await CometChat.sendMessage(textMessage);
  console.log("Message sent successfully:", message);
} catch (error) {
  console.log("Message sending failed with error:", error);
}

let receiverID: string = "GUID",
  messageText: string = "Hello world!",
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  textMessage: CometChat.TextMessage = new CometChat.TextMessage(
    receiverID,
    messageText,
    receiverType
  );

CometChat.sendMessage(textMessage).then(
(message: CometChat.TextMessage) => {
console.log("Message sent successfully:", message);
},
(error: CometChat.CometChatException) => {
console.log("Message sending failed with error:", error);
}
);

let receiverID = "GUID";
let messageText = "Hello world!";
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let textMessage = new CometChat.TextMessage(
  receiverID,
  messageText,
  receiverType
);

CometChat.sendMessage(textMessage).then(
  (message) => {
    console.log("Message sent successfully:", message);
  },
  (error) => {
    console.log("Message sending failed with error:", error);
  }
);

The TextMessage class constructor takes the following parameters:

Parameter	Description	Required
`receiverID`	UID of the user or GUID of the group receiving the message	Yes
`messageText`	The text message content	Yes
`receiverType`	`CometChat.RECEIVER_TYPE.USER` or `CometChat.RECEIVER_TYPE.GROUP`	Yes

On success, sendMessage() method returns a TextMessage | MediaMessage | CustomMessage | BaseMessage object depending on the input message type.

Send While Offline

With offline support enabled, pass a MessageSentListener as the second argument to queue the message when the device has no connection. The same listener works with sendMediaMessage() and sendCustomMessage().

TypeScript
JavaScript

CometChat.sendMessage(
  textMessage,
  new CometChat.MessageSentListener({
    onMessagePending: (message: CometChat.BaseMessage) => {
      // Queued on the device; message.getStatus() === "PENDING"
    },
    onMessageSent: (message: CometChat.BaseMessage) => {
      // The server accepted the message
    },
    onError: (error: CometChat.CometChatException) => {
      // Offline, this also fires as a queued-not-failed notice (code FAILED_TO_FETCH)
    },
  })
).catch(() => {});

CometChat.sendMessage(
  textMessage,
  new CometChat.MessageSentListener({
    onMessagePending: (message) => {
      // Queued on the device; message.getStatus() === "PENDING"
    },
    onMessageSent: (message) => {
      // The server accepted the message
    },
    onError: (error) => {
      // Offline, this also fires as a queued-not-failed notice (code FAILED_TO_FETCH)
    },
  })
).catch(() => {});

Offline, onMessagePending fires first, then onError with code FAILED_TO_FETCH as a not-connected notice, and onMessageSent follows once the message is sent on reconnect. In onError, look the message up with getPendingMessages() and check its getStatus(): PENDING means queued, FAILED means it failed. A send without a MessageSentListener is never queued; offline, its Promise rejects. See Send While Offline.

Media Message

Send images, videos, audio, or files using CometChat.sendMediaMessage(). There are two ways to send media messages:

Upload a file — Pass a file object and CometChat uploads it automatically
Send a URL — Provide a URL to media hosted on your server or cloud storage

Upload a File

Get the file from an input element and pass it to MediaMessage:

<input type="file" name="img_file" id="img_file" />

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  file: File = (document.getElementById("img_file") as HTMLInputElement).files![0];

let mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
receiverID,
file,
messageType,
receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "UID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.USER;
let file = document.getElementById("img_file").files[0];

let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  file,
  messageType,
  receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

let receiverID: string = "GUID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  file: File = (document.getElementById("img_file") as HTMLInputElement).files![0];

let mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
receiverID,
file,
messageType,
receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "GUID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let file = document.getElementById("img_file").files[0];

let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  file,
  messageType,
  receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

Send a URL

Send media hosted on your server or cloud storage using the Attachment class:

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
    receiverID,
    "",
    messageType,
    receiverType
  );

let file: Object = {
name: "mario",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment: CometChat.Attachment = new CometChat.Attachment(file);
mediaMessage.setAttachment(attachment);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "UID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.USER;
let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  "",
  messageType,
  receiverType
);

let file = {
  name: "mario",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment = new CometChat.Attachment(file);
mediaMessage.setAttachment(attachment);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

let receiverID: string = "GUID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
    receiverID,
    "",
    messageType,
    receiverType
  );

let file: Object = {
name: "mario",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment: CometChat.Attachment = new CometChat.Attachment(file);
mediaMessage.setAttachment(attachment);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "GUID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  "",
  messageType,
  receiverType
);

let file = {
  name: "mario",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment = new CometChat.Attachment(file);
mediaMessage.setAttachment(attachment);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

The MediaMessage class constructor takes the following parameters:

Parameter	Description	Required
`receiverID`	UID of the user or GUID of the group	Yes
`file`	File object to upload, or empty string if using URL	Yes
`messageType`	`CometChat.MESSAGE_TYPE.IMAGE`, `VIDEO`, `AUDIO`, or `FILE`	Yes
`receiverType`	`CometChat.RECEIVER_TYPE.USER` or `GROUP`	Yes

On success, sendMediaMessage() returns a MediaMessage object.

With offline support enabled, pass a MessageSentListener to sendMediaMessage() to queue the message while offline. onError can then mean “queued”, not “failed”: check the message’s status. See Send While Offline.

Add Caption

Add text along with the media:

TypeScript
JavaScript

typescript mediaMessage.setCaption("Check out this photo!");

javascript mediaMessage.setCaption("Check out this photo!");

Add Metadata and Tags

Same as text messages:

mediaMessage.setMetadata({ location: "Paris" });
mediaMessage.setTags(["vacation"]);
mediaMessage.setQuotedMessageId(10);

The sendMediaMessage() method returns a MediaMessage object.

Multiple Attachments in a Media Message

The SDK supports sending multiple attachments in a single media message. A media message can carry up to a configurable maximum number of attachments (default 10, controlled by the file.count.max app setting). sendMediaMessage() rejects with ERR_FILE_COUNT_EXCEEDED if you exceed it — read the current limit at runtime with CometChat.getMaxAttachmentCount().

Recommended: upload first, then send. For a real composer — where you want a progress bar per file, and the ability to remove or retry individual files — create an upload request with CometChat.createUploadFileRequest(), upload your files through it, then collect the resulting Attachments (request.getAttachments()) and attach them here with setAttachments(). This decouples the (slow, cancellable) upload from the (instant) send. See Upload Files & Send Attachments for the full flow.

There are two ways to send a multi-attachment media message using the CometChat SDK:

By providing an array of files: You can share an array of files while creating an object of the MediaMessage class. When the media message is sent using the sendMediaMessage() method, the files are uploaded to the CometChat servers & the URL of the files is sent in the success response of the sendMediaMessage() method. This is the simplest path, but it gives no upload progress and no per-file cancel/retry — for that, upload first.

Getting files:

html

<html>
  <body>
    <input type="file" name="img_file" id="img_file" />
    <script>
      const UID = "UID";
      const files = document.getElementById("img_file").files;
      const fileType = MESSAGE_TYPE.IMAGE;
      const userType = CometChat.RECEIVER_TYPE.USER;
      const mediaMessage = new MediaMessage(UID, files, fileType, userType);
    </script>
  </body>
</html>

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  messageType: string = CometChat.MESSAGE_TYPE.FILE,
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  files: FileList = (document.getElementById("img_file") as HTMLInputElement).files!;

let mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
receiverID,
files,
messageType,
receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "UID";
let messageType = CometChat.MESSAGE_TYPE.FILE;
let receiverType = CometChat.RECEIVER_TYPE.USER;
let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  files,
  messageType,
  receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

let receiverID: string = "GUID",
  messageType: string = CometChat.MESSAGE_TYPE.FILE,
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  files: FileList = (document.getElementById("img_file") as HTMLInputElement).files!;

let mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
receiverID,
files,
messageType,
receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "GUID";
let messageType = CometChat.MESSAGE_TYPE.FILE;
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let files = document.getElementById("img_file").files;

let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  files,
  messageType,
  receiverType
);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

Send Multiple URLs

Provide an array of Attachment objects that already point at hosted URLs. This is also the path the upload-then-send flow uses — the Attachments from an upload request’s getAttachments() are ready to pass straight to setAttachments().

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
    receiverID,
    "",
    messageType,
    receiverType
  );

let attachment1: Object = {
name: "mario",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment2: Object = {
name: "jaguar",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/jaguar/jaguar_PNG20759.png",
};

let attachments: Array<CometChat.Attachment> = [];
attachments.push(new CometChat.Attachment(attachment1));
attachments.push(new CometChat.Attachment(attachment2));

mediaMessage.setAttachments(attachments);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "UID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.USER;
let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  "",
  messageType,
  receiverType
);

let attachment1 = {
  name: "mario",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment2 = {
  name: "jaguar",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/jaguar/jaguar_PNG20759.png",
};

let attachments = [];
attachments.push(new CometChat.Attachment(attachment1));
attachments.push(new CometChat.Attachment(attachment2));

mediaMessage.setAttachments(attachments);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

let receiverID: string = "GUID",
  messageType: string = CometChat.MESSAGE_TYPE.IMAGE,
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  mediaMessage: CometChat.MediaMessage = new CometChat.MediaMessage(
    receiverID,
    "",
    messageType,
    receiverType
  );

let attachment1: Object = {
name: "mario",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment2: Object = {
name: "jaguar",
extension: "png",
mimeType: "image/png",
url: "https://pngimg.com/uploads/jaguar/jaguar_PNG20759.png",
};

let attachments: Array<CometChat.Attachment> = [];
attachments.push(new CometChat.Attachment(attachment1));
attachments.push(new CometChat.Attachment(attachment2));

mediaMessage.setAttachments(attachments);

CometChat.sendMediaMessage(mediaMessage).then(
(message: CometChat.MediaMessage) => {
console.log("Media message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Media message sending failed with error", error);
}
);

let receiverID = "GUID";
let messageType = CometChat.MESSAGE_TYPE.IMAGE;
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let mediaMessage = new CometChat.MediaMessage(
  receiverID,
  "",
  messageType,
  receiverType
);

let attachment1 = {
  name: "mario",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/mario/mario_PNG125.png",
};

let attachment2 = {
  name: "jaguar",
  extension: "png",
  mimeType: "image/png",
  url: "https://pngimg.com/uploads/jaguar/jaguar_PNG20759.png",
};

let attachments = [];
attachments.push(new CometChat.Attachment(attachment1));
attachments.push(new CometChat.Attachment(attachment2));

mediaMessage.setAttachments(attachments);

CometChat.sendMediaMessage(mediaMessage).then(
  (message) => {
    console.log("Media message sent successfully", message);
  },
  (error) => {
    console.log("Media message sending failed with error", error);
  }
);

Custom Message

Send structured data that doesn’t fit text or media categories — like location coordinates, polls, or game moves.

TypeScript (User)
JavaScript (User)
TypeScript (Group)
JavaScript (Group)

let receiverID: string = "UID",
  customData: Object = {
    latitude: "50.6192171633316",
    longitude: "-72.68182268750002",
  },
  customType: string = "location",
  receiverType: string = CometChat.RECEIVER_TYPE.USER,
  customMessage: CometChat.CustomMessage = new CometChat.CustomMessage(
    receiverID,
    receiverType,
    customType,
    customData
  );

CometChat.sendCustomMessage(customMessage).then(
(message: CometChat.CustomMessage) => {
console.log("Custom message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Custom message sending failed with error", error);
}
);

let receiverID = "UID";
let customData = {
  latitude: "50.6192171633316",
  longitude: "-72.68182268750002",
};
let customType = "location";
let receiverType = CometChat.RECEIVER_TYPE.USER;

let customMessage = new CometChat.CustomMessage(
  receiverID,
  receiverType,
  customType,
  customData
);

CometChat.sendCustomMessage(customMessage).then(
  (message) => {
    console.log("Custom message sent successfully", message);
  },
  (error) => {
    console.log("Custom message sending failed with error", error);
  }
);

let receiverID: string = "GUID",
  customData: Object = {
    latitude: "50.6192171633316",
    longitude: "-72.68182268750002",
  },
  customType: string = "location",
  receiverType: string = CometChat.RECEIVER_TYPE.GROUP,
  customMessage: CometChat.CustomMessage = new CometChat.CustomMessage(
    receiverID,
    receiverType,
    customType,
    customData
  );

CometChat.sendCustomMessage(customMessage).then(
(message: CometChat.CustomMessage) => {
console.log("Custom message sent successfully", message);
},
(error: CometChat.CometChatException) => {
console.log("Custom message sending failed with error", error);
}
);

let receiverID = "GUID";
let customData = {
  latitude: "50.6192171633316",
  longitude: "-72.68182268750002",
};
let customType = "location";
let receiverType = CometChat.RECEIVER_TYPE.GROUP;

let customMessage = new CometChat.CustomMessage(
  receiverID,
  receiverType,
  customType,
  customData
);

CometChat.sendCustomMessage(customMessage).then(
  (message) => {
    console.log("Custom message sent successfully", message);
  },
  (error) => {
    console.log("Custom message sending failed with error", error);
  }
);

The CustomMessage class constructor takes the following parameters:

Parameter	Description	Required
`receiverID`	UID of the user or GUID of the group	Yes
`receiverType`	`CometChat.RECEIVER_TYPE.USER` or `GROUP`	Yes
`customType`	Your custom type string (e.g., `"location"`, `"poll"`)	Yes
`customData`	JSON object with your custom data	Yes

On success, sendCustomMessage() returns a CustomMessage object.

With offline support enabled, pass a MessageSentListener to sendCustomMessage() to queue the message while offline. onError can then mean “queued”, not “failed”: check the message’s status. See Send While Offline.

Add Tags

customMessage.setTags(["starredMessage"]);

Quote a Message

customMessage.setQuotedMessageId(10);

Control Conversation Update

By default, custom messages update the conversation’s last message. To prevent this:

customMessage.shouldUpdateConversation(false);

Control Notifications

By default, custom messages don’t trigger notifications (push, email, or SMS). To enable them, call shouldSendNotification(true) before sending. See Custom message templates for how notifications are handled for custom messages.

// Enable notification sending for this custom message
customMessage.shouldSendNotification(true);

Custom Notification Text

Set custom text for push, email, and SMS notifications. Notifications use this text only when they’re enabled for the message (see Control Notifications). It is also shown as the conversation-list preview.

customMessage.setConversationText("Shared a location");
customMessage.shouldSendNotification(true);

The sendCustomMessage() method returns a CustomMessage object.

Card Message

A CardMessage (category card) is a rich, structured card rendered from Card Schema JSON.

Design cards visually with Card Builder. Build your card messages in the CometChat Dashboard and export the Card Schema JSON — instead of writing it by hand.

Card messages cannot be sent through the SDK. CardMessage is receive-only — there is no sendCardMessage() method. Cards are created server-side via the Platform (REST) API or the Dashboard Bubble Builder, and delivered to clients through the onCardMessageReceived callback of the MessageListener.

To receive and render cards, see the Card Messages guide.

Next Steps

Receive Messages

Listen for incoming messages in real-time

Edit Message

Edit previously sent messages

Delete Message

Delete sent messages

​Text Message

​Send While Offline

​Media Message

​Upload a File

​Send a URL

​Add Caption

​Add Metadata and Tags

​Multiple Attachments in a Media Message

​Send Multiple URLs

​Custom Message

​Add Tags

​Quote a Message

​Control Conversation Update

​Control Notifications

​Custom Notification Text

​Card Message

​Next Steps

Receive Messages

Edit Message

Delete Message

Text Message

Send While Offline

Media Message

Upload a File

Send a URL

Add Caption

Add Metadata and Tags

Multiple Attachments in a Media Message

Send Multiple URLs

Custom Message

Add Tags

Quote a Message

Control Conversation Update

Control Notifications

Custom Notification Text

Card Message

Next Steps