Transient Messages

Send and receive ephemeral real-time messages that are not stored on the server using the CometChat JavaScript SDK. Ideal for live reactions and temporary indicators.

AI Integration Quick Reference

// Send transient message to user
const msg = new CometChat.TransientMessage("UID", CometChat.RECEIVER_TYPE.USER, { LIVE_REACTION: "heart" });
CometChat.sendTransientMessage(msg);

// Listen for transient messages
CometChat.addMessageListener("LISTENER_ID", new CometChat.MessageListener({
  onTransientMessageReceived: (msg) => console.log("Transient:", msg)
}));

Transient messages are messages that are sent in real-time only and are not saved or tracked anywhere. The receiver of the message will only receive the message if he is online and these messages cannot be retrieved later.

Send a Transient Message

You can use the sendTransientMessage() method to send a transient message to a user or in a group. The receiver will receive this information in the onTransientMessageReceived() method of the MessageListener class. In order to send the transient message, you need to use the TransientMessage class.

User

let receiverId = "UID";
let receiverType = CometChat.RECEIVER_TYPE.USER;
let data = { "LIVE_REACTION": "heart" };

let transientMessage = new CometChat.TransientMessage(receiverId, receiverType, data);
CometChat.sendTransientMessage(transientMessage);

Group

let receiverId = "GUID";
let receiverType = CometChat.RECEIVER_TYPE.GROUP;
let data = { "LIVE_REACTION": "heart" };

let transientMessage = new CometChat.TransientMessage(receiverId, receiverType, data);
CometChat.sendTransientMessage(transientMessage); 

User (Typescript)

let receiverId: string = "UID";
let receiverType: string = CometChat.RECEIVER_TYPE.USER;
let data: Object = { "LIVE_REACTION": "heart" };

let transientMessage: CometChat.TransientMessage = new CometChat.TransientMessage(receiverId, receiverType, data);
CometChat.sendTransientMessage(transientMessage);

Group (Typescript)

let receiverId: string = "GUID";
let receiverType: string = CometChat.RECEIVER_TYPE.GROUP;
let data: Object = { "LIVE_REACTION": "heart" };

let transientMessage: CometChat.TransientMessage = new CometChat.TransientMessage(receiverId, receiverType, data);
CometChat.sendTransientMessage(transientMessage);

Real-time Transient Messages

Always remove listeners when they’re no longer needed (e.g., on component unmount or page navigation). Failing to remove listeners can cause memory leaks and duplicate event handling.

You will receive the transient message in the onTransientMessageReceived() method of the registered MessageListener class.

Message Listener

let listenerId = "UNIQUE_LITENER_ID";

CometChat.addMessageListener(
listenerId,
new CometChat.MessageListener({
  onTransientMessageReceived: transientMessage => {
    console.log('transient message received', transientMessage);
  },
})
);   

TypeScript

let listenerId: string = "UNIQUE_LITENER_ID";

CometChat.addMessageListener(
  listenerId,
  new CometChat.MessageListener({
      onTransientMessageReceived: (transientMessage: CometChat.TransientMessage) => {
          console.log('transient message received', transientMessage);
      },
  })
);

The TransientMessage class consists of the below parameters:

Parameter	Information
sender	An object of the User class holding all the information. related to the sender of the transient message.
receiverId	Unique Id of the receiver. This can be the Id of the group or the user the transient message is sent to.
receiverType	The type of the receiver - CometChat.RECEIVER_TYPE.USER or CometChat.RECEIVER_TYPE.GROUP
data	A JSONObject to provide data.

The listener callback receives a TransientMessage object. Access the data using getter methods:

Field	Getter	Return Type	Description
sender	getSender()	User	The user who sent the transient message
receiverId	getReceiverId()	string	UID or GUID of the receiver
receiverType	getReceiverType()	string	Type of receiver (user or group)
data	getData()	Object	Custom JSON data payload

---

Next Steps

Typing Indicators

Show real-time typing status in conversations

Send Messages

Send text, media, and custom messages