Conversation Starter

Generate CometChat AI conversation starters from recent messages to help users begin new chat conversations.

Conversation Starter enables you to retrieve an initial message in a new conversation, often used to set the context for the conversation that is about to begin. This can be particularly useful for guiding users on how to interact within the chat or for delivering automated messages that engage users when they initiate a chat.

Before you begin

1. Set up the AI settings through the CometChat dashboard as detailed in the Overview section.

2. Navigate to Chat > Features, under AI User Copilot, enable Conversation Starter.

   

3. Implement the chat functionality in your applications using CometChat’s v4 Chat SDKs.

How does it work?

CometChat AI analyzes the user’s tone and writing style by reviewing recent messages sent by that user within the application.

The SDK includes a method for retrieving conversation starters in a chat. This method returns an array containing three potential starters for the conversation.

The number of messages to be fetched to generate relevant conversation starter is configurable. By default the CometChat AI takes the latest 1000 messages. This can be configured to specific timestamps as well.

Configuration	Value
lastNMessages	This will fetch specific number of messages.
fromTimestamp	This will fetch messages from a particular timestamp.
toTimestamp	This will fetch messages until a particular timestamp.

While using any configuration mentioned above a maximum of only 1000 messages will be fetched.

Implementation

SDKs

To implement Conversation Starter in the platform of your choice, you may utilize the following code samples:

JS/React Native/Ionic SDK

const receiverId = 'UID/GUID';
const receiverType = 'user/group';
const configuration = {lastNMessages: 100};

CometChat.getConversationStarter(receiverId, receiverType, configuration).then(
	(conversationStarter) => {
  	console.log("Conversation Starter", conversationStarter);
  },
  (error) => {
  	console.log("An error occurred while fetching conversation starter", error);
  }
);

Java

String receiveId = "";
String receiverType = CometChatConstants.RECEIVER_TYPE_USER;

JSONObject configuration = new JSONObject();
try {
    configuration.put("lastNMessages", 100);
} catch (JSONException e) {
    throw new RuntimeException(e);
}

CometChat.getConversationStarter(receiveId, receiverType, configuration, new CometChat.CallbackListener<List<String>>() {
    @Override
    public void onSuccess(List<String> strings) {
        Log.e(TAG, strings.toString());
    }
    @Override
    public void onError(CometChatException e) {
        Log.e(TAG, e.getMessage());
    }
});

Kotlin

val receiveId = ""
val receiverType: String = CometChatConstants.RECEIVER_TYPE_USER
val configuration = JSONObject()
try {
    configuration.put("lastNMessages", 100)
} catch (e: JSONException) {
    throw RuntimeException(e)
}

CometChat.getConversationStarter(
    receiveId,
    receiverType,
    configuration,
    object : CallbackListener<List<String?>?>() {
        fun onSuccess(strings: List<String?>) {
            Log.e(SplashActivity.TAG, strings.toString())
        }

        override fun onError(e: CometChatException) {
            Log.e(SplashActivity.TAG, e.getMessage())
        }
    }
)

Dart

String receiveId = "";
String receiverType = CometChatConversationType.user;
Map configuration = { "lastNMessages": 100 };

CometChat.getConversationStarter("cometchat-uid-2", "user", configuration: configuration, onSuccess: (List<String> starters) {
    debugPrint("getConversationStarter Sucess: $starters");
}, onError: (CometChatException e) {
    debugPrint("getConversationStarter Error: $e");
});

Swift

let receiverId = ""
let receiverType = CometChat.ReceiverType.group
let configuration = [ "lastNMessages": 100 ]


CometChat.getConversationStarter(receiverId: "cometchat-uid-1", receiverType: .user, configuration: configuration) { startersReplies in
    print("getConversationStarter success: \(startersReplies)")
} onError: { error in
    print("getConversationStarter error: \(error?.errorDescription)")
}

UI Kits

Assuming the necessary prerequisites are met, Conversation Starter functions seamlessly starting from v4 of the Chat UI Kits. No additional code is required: once you enable Conversation Starter in the dashboard, the UI Kit renders the suggestions automatically. It is triggered when there are no messages in a conversation, and in the React UI Kit it appears inside the Message List component.

For details on how each AI feature maps to a UI Kit component, see Smart Chat Features in the React UI Kit.

Related

Smart Replies

AI-generated reply suggestions for an ongoing conversation.

Conversation Summary

A short recap of a long or unread conversation.

AI Settings

Configure your OpenAI model and key, then enable AI features.

React UI Kit AI Features

See which UI Kit component renders each AI feature.