Message Privately

Initiate private one-on-one chats with group members directly from group chat in CometChat Flutter UI Kit.

AI Agent Component Spec

Field	Value
Package	cometchat_chat_uikit
Key components	CometchatUserInfo, CometChatMessageList, PageManager
Init	CometChatUIKit.init(uiKitSettings) then CometChatUIKit.login(uid)
Entry point	Group member tap → CometchatUserInfo → “Message” action
Sample app	GitHub
Related	All Guides

Message Privately lets users start a direct one-on-one chat with a group member without leaving the group context.

Before starting, complete the Getting Started guide.

---

Components

Component / Class	Role
CometChatMessageList	Displays group messages and user avatars
CometchatUserInfo	Shows user details and actions (e.g., call, message)
CometChatUserInfoController	Manages user info state and actions
PageManager	Handles navigation to the private chat screen

---

Integration Steps

1. Navigate to User Info

Open the user info screen when tapping on a group member’s profile or info icon.

File: cometchat_group_info.dart

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => CometchatUserInfo(user: selectedUser),
  ),
);

---

2. Display User Profile with Actions

The CometchatUserInfo widget displays the user’s profile with action tiles for voice call, video call, and messaging.

File: cometchat_user_info.dart

Widget _getOptionTiles(CometChatUserInfoController controller) {
  return Row(
    mainAxisAlignment: MainAxisAlignment.spaceBetween,
    children: [
      tile(
        Icon(Icons.call_outlined, color: colorPalette.iconHighlight),
        Translations.of(context).voice,
        () => controller.initiateCallWorkflow(CallTypeConstants.audioCall, context),
      ),
      tile(
        Icon(Icons.videocam_outlined, color: colorPalette.iconHighlight),
        Translations.of(context).video,
        () => controller.initiateCallWorkflow(CallTypeConstants.videoCall, context),
      ),
    ],
  );
}

---

3. Start Private Chat

Navigate to the private chat screen using PageManager when the user wants to message privately.

File: page_manager.dart

PageManager().navigateToMessages(
  context: context,
  user: user,
);

---

4. Handle Mentions Navigation

When a user taps on a mention in a message, navigate to that user’s profile or start a private chat.

File: cometchat_thread.dart

CometChatMentionsFormatter getMentionsTap() {
  return CometChatMentionsFormatter(
    user: widget.user,
    group: widget.group,
    onMentionTap: (mention, mentionedUser, {message}) {
      if (mentionedUser.uid != CometChatUIKit.loggedInUser!.uid) {
        PageManager().navigateToMessages(
          context: context,
          user: mentionedUser,
        );
      }
    },
  );
}

---

Feature Matrix

Feature	Component / Method	File
User info screen	CometchatUserInfo	cometchat_user_info.dart
Voice/video call	initiateCallWorkflow()	cometchat_user_info_controller.dart
Navigate to chat	PageManager.navigateToMessages	page_manager.dart
Mention tap	CometChatMentionsFormatter	cometchat_thread.dart
Access from group	Group member list	cometchat_group_info.dart

---

Next Steps

Groups

Display and manage group lists.

Group Members

View and manage group members.

Message List

Display messages in private chats.

All Guides

Browse all feature and formatter guides.