Message Privately - CometChat Docs

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. 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,
);

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.

​Components

​Integration Steps

​1. Navigate to User Info

​2. Display User Profile with Actions

​3. Start Private Chat

​4. Handle Mentions Navigation

​Feature Matrix

​Next Steps