Message Privately

​

Overview

• Quick entry into a one-on-one conversation from a user context.
• Automatic conversation creation if none exists.
• Optional initial message send to surface the chat in lists.

​

Prerequisites

• Android Studio project with cometchat-pro/android-chat-sdk v4.0.0+ and cometchat-pro/android-java-uikit v4.0.0+ in build.gradle.
• Valid CometChat App ID, Auth Key, and Region initialized.
• <uses-permission android:name="android.permission.INTERNET"/> in AndroidManifest.xml.
• Users created in your CometChat app.
• User must be logged in via CometChatUIKit.login() before invoking this feature.
• Existing MessagesActivity capable of handling one-on-one chats.

​

Components

​

Integration Steps

​

1. Launch One-on-One Chat from Profile

// In UserDetailsActivity.java
binding.messagePrivatelyBtn.setOnClickListener(v -> {
  Intent intent = new Intent(this, MessagesActivity.class);
  intent.putExtra(getString(R.string.app_user), new Gson().toJson(user));
  startActivity(intent);
});

​

2. Handle Incoming Intent in Chat Screen

// In MessagesActivity.java
@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_messages);

  String userJson = getIntent().getStringExtra(getString(R.string.app_user));
  if (userJson != null) {
    User user = new Gson().fromJson(userJson, User.class);
    messageHeader.setUser(user);
    messageList.setUser(user);
    composer.setUser(user);
  }
}

​

3. (Optional) Programmatically Create Conversation

// In MainActivity.java
txtMessage = new TextMessage(
  "cometchat-uid-2",
  "👋",
  CometChatConstants.RECEIVER_TYPE_USER
);
CometChat.sendMessage(txtMessage, new CometChat.CallbackListener<BaseMessage>() {
  @Override public void onSuccess(BaseMessage msg) {
    Log.d("SendMsg", "Initial message sent.");
  }
  @Override public void onError(CometChatException e) {
    Log.e("SendMsg", e.getMessage());
  }
});

​

Implementation Flow

​

Customization Options

• Button Text & Style: Update messagePrivatelyBtn in activity_user_details.xml.
• Intent Extras Key: Use a custom key instead of R.string.app_user.
• Dummy Message: Customize initial message content or omit step if undesired.

​

Edge Cases

​

Summary / Feature Matrix