AI Integration Quick Reference

Field	Value
Package	`@cometchat/chat-sdk-javascript`
AI Features	AI Agents, AI Moderation, AI User Copilot
Activation	Enable from CometChat Dashboard
Prerequisites	`CometChat.init()` + `CometChat.login()` completed
AI Agents	Real-time streaming via `AIAssistantListener`, persisted messages via `MessageListener`
AI Moderation	Automatic content moderation with `PENDING` → `APPROVED` / `DISAPPROVED` flow
AI User Copilot	Smart Replies, Conversation Starter, Conversation Summary (Dashboard-enabled)

Overview

CometChat provides three AI-powered features to enhance your chat application:

Feature	Description	Use Case
AI Agents	Intelligent automated conversations with real-time streaming	Chatbots, virtual assistants, automated support
AI Moderation	Automatic content moderation for text, image, and video messages	Safety, compliance, content filtering
AI User Copilot	Smart replies, conversation starters, and summaries	Enhanced user experience, productivity

AI Features Summary

AI Agents

AI Agents enable intelligent, automated interactions. They process user messages, trigger tools, and respond with contextually relevant information. Key Points:

Agents only respond to text messages
Real-time events via AIAssistantListener
Persisted messages via MessageListener
Event flow: Run Start → Tool Call(s) → Text Message Stream → Run Finished

TypeScript
JavaScript

const listnerId: string = "unique_listener_id";

// Adding the AIAssistantListener for real-time events
CometChat.addAIAssistantListener(listnerId, {
  onAIAssistantEventReceived: (message: CometChat.AIAssistantBaseEvent) => {
    console.log("AIAssistant event received successfully", message);
  }
});

// Adding the MessageListener for persisted agentic messages
CometChat.addMessageListener(listnerId, {
  onAIAssistantMessageReceived: (message: CometChat.AIAssistantMessage) => {
    console.log("AI Assistant message received successfully", message);
  },
  onAIToolResultReceived: (message: CometChat.AIToolResultMessage) => {
    console.log("AI Tool result message received successfully", message);
  },
  onAIToolArgumentsReceived: (message: CometChat.AIToolArgumentMessage) => {
    console.log("AI Tool argument message received successfully", message);
  },
});

// Cleanup - always remove listeners when done
CometChat.removeAIAssistantListener(listnerId);
CometChat.removeMessageListener(listnerId);

const listnerId = "unique_listener_id";

// Adding the AIAssistantListener for real-time events
CometChat.addAIAssistantListener(listnerId, {
  onAIAssistantEventReceived: (message) => {
    console.log("AIAssistant event received successfully", message);
  }
});

// Adding the MessageListener for persisted agentic messages
CometChat.addMessageListener(listnerId, {
  onAIAssistantMessageReceived: (message) => {
    console.log("AI Assistant message received successfully", message);
  },
  onAIToolResultReceived: (message) => {
    console.log("AI Tool result message received successfully", message);
  },
  onAIToolArgumentsReceived: (message) => {
    console.log("AI Tool argument message received successfully", message);
  },
});

// Cleanup - always remove listeners when done
CometChat.removeAIAssistantListener(listnerId);
CometChat.removeMessageListener(listnerId);

AI Moderation

AI Moderation automatically reviews messages for inappropriate content in real-time. Key Points:

Supports Text, Image, and Video messages only
Moderation statuses: PENDING → APPROVED or DISAPPROVED
Enable and configure rules in the CometChat Dashboard

TypeScript
JavaScript

// Send message and check initial moderation status
const textMessage = new CometChat.TextMessage(
  receiverUID,
  "Hello, how are you?",
  CometChat.RECEIVER_TYPE.USER
);

CometChat.sendMessage(textMessage).then(
  (message: CometChat.TextMessage) => {
    const status: string = message.getModerationStatus();
    
    if (status === CometChat.ModerationStatus.PENDING) {
      console.log("Message is under moderation review");
    }
  },
  (error: CometChat.CometChatException) => {
    console.log("Message sending failed:", error);
  }
);

// Listen for moderation results
const listenerID: string = "MODERATION_LISTENER";

CometChat.addMessageListener(
  listenerID,
  new CometChat.MessageListener({
    onMessageModerated: (message: CometChat.BaseMessage) => {
      const status: string = message.getModerationStatus();
      const messageId: number = message.getId();

      switch (status) {
        case CometChat.ModerationStatus.APPROVED:
          console.log(`Message ${messageId} approved`);
          break;
        case CometChat.ModerationStatus.DISAPPROVED:
          console.log(`Message ${messageId} blocked`);
          break;
      }
    }
  })
);

// Send message and check initial moderation status
const textMessage = new CometChat.TextMessage(
  receiverUID,
  "Hello, how are you?",
  CometChat.RECEIVER_TYPE.USER
);

CometChat.sendMessage(textMessage).then(
  (message) => {
    const status = message.getModerationStatus();
    
    if (status === CometChat.ModerationStatus.PENDING) {
      console.log("Message is under moderation review");
    }
  },
  (error) => {
    console.log("Message sending failed:", error);
  }
);

// Listen for moderation results
const listenerID = "MODERATION_LISTENER";

CometChat.addMessageListener(
  listenerID,
  new CometChat.MessageListener({
    onMessageModerated: (message) => {
      const status = message.getModerationStatus();
      const messageId = message.getId();

      switch (status) {
        case CometChat.ModerationStatus.APPROVED:
          console.log(`Message ${messageId} approved`);
          break;
        case CometChat.ModerationStatus.DISAPPROVED:
          console.log(`Message ${messageId} blocked`);
          break;
      }
    }
  })
);

AI User Copilot

AI User Copilot provides smart features that enhance user productivity. These features are enabled in the Dashboard and auto-integrate with UI Kits.

Feature	Description	Documentation
Conversation Starter	AI-generated opening lines for new chats	Learn more
Smart Replies	AI-generated response suggestions	Learn more
Conversation Summary	AI-generated recap of long conversations	Learn more

Configuration Options

AI Agents Configuration

Parameter	Type	Description
`listenerId`	`string`	Unique identifier for the listener
`onAIAssistantEventReceived`	`function`	Callback for real-time streaming events
`onAIAssistantMessageReceived`	`function`	Callback for persisted assistant messages
`onAIToolResultReceived`	`function`	Callback for tool execution results
`onAIToolArgumentsReceived`	`function`	Callback for tool arguments

AI Moderation Configuration

Parameter	Type	Description
`listenerID`	`string`	Unique identifier for the listener
`onMessageModerated`	`function`	Callback when moderation result is available

Moderation Status Values

Status	Enum	Description
Pending	`CometChat.ModerationStatus.PENDING`	Message is being processed
Approved	`CometChat.ModerationStatus.APPROVED`	Message passed moderation
Disapproved	`CometChat.ModerationStatus.DISAPPROVED`	Message was blocked

Next Steps

AI Agents

Full documentation for AI Agents integration

AI Moderation

Complete AI Moderation implementation guide

AI User Copilot

Smart Replies, Conversation Starter, and Summary

Troubleshooting

Common issues and fixes

​Overview

​AI Features Summary

​AI Agents

​AI Moderation

​AI User Copilot

​Configuration Options

​AI Agents Configuration

​AI Moderation Configuration

​Moderation Status Values

​Next Steps

AI Agents

AI Moderation

AI User Copilot

Troubleshooting

Overview

AI Features Summary

AI Agents

AI Moderation

AI User Copilot

Configuration Options

AI Agents Configuration

AI Moderation Configuration

Moderation Status Values

Next Steps