AI Features - CometChat Docs

AI Agent Feature Spec

{
  "category": "ai",
  "features": [
    {"name": "aiAgentChat", "description": "Chat with AI-powered assistants", "component": "CometChatMessages", "enabledByDefault": false},
    {"name": "chatHistory", "description": "Browse and resume previous AI sessions", "component": "CometChatAIAssistanceChatHistory", "enabledByDefault": false},
    {"name": "streamingResponses", "description": "Real-time AI message streaming", "component": "CometChatMessageList", "enabledByDefault": false},
    {"name": "suggestedMessages", "description": "AI-powered conversation starters and smart replies", "component": "CometChatMessageComposer", "enabledByDefault": false}
  ],
  "dashboardSetup": {
    "location": "CometChat Dashboard → AI",
    "features": ["Conversation Starter", "Smart Replies", "Conversation Summary"]
  },
  "relatedComponents": ["CometChatMessages", "CometChatAIAssistanceChatHistory", "CometChatMessageList", "CometChatMessageComposer"]
}

Overview

CometChat AI features enhance your chat experience with intelligent suggestions and summaries. Once enabled in your dashboard, they integrate automatically into the UI Kit components.

Feature	What It Does	Where It Appears
Conversation Starters	Suggests opening messages for new chats	`CometChatMessageList`
Smart Replies	Suggests responses based on context	`CometChatMessageComposer`
Conversation Summary	Summarizes long conversations	`CometChatMessageComposer`
AI Assistant	Chat with AI bot	`CometChatAIAssistanceChatHistory`

Enable AI Features

Open CometChat Dashboard

Go to app.cometchat.com and select your app.

Navigate to AI Features

Click AI in the sidebar, then enable the features you want:

✅ Conversation Starter
✅ Smart Replies
✅ Conversation Summary

Configure (Optional)

Customize AI behavior, response style, and triggers in the dashboard settings.

That’s it! AI features now work automatically in your app.

Conversation Starters

When a user opens a new chat with no message history, AI suggests conversation openers.

How It Works

User opens chat with someone they haven’t messaged before
AI analyzes user profiles and context
Suggested messages appear in the message list
User taps a suggestion to send it

Implementation

Conversation starters appear automatically in CometChatMessages:

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

class ChatViewController: UIViewController {
    
    func openChatWithUser(uid: String) {
        CometChat.getUser(UID: uid) { [weak self] user in
            DispatchQueue.main.async {
                let messagesVC = CometChatMessages()
                messagesVC.user = user
                
                // Conversation starters appear automatically
                // if enabled in dashboard and no previous messages exist
                
                self?.navigationController?.pushViewController(messagesVC, animated: true)
            }
        } onError: { error in
            print("Error: \(error?.errorDescription ?? "")")
        }
    }
}

Smart Replies

AI suggests contextual responses based on the conversation.

How It Works

User receives a message
AI analyzes the message and conversation context
Smart reply suggestions appear in the composer action sheet
User taps a suggestion to insert it

Implementation

Smart replies appear automatically in CometChatMessageComposer:

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

class ChatViewController: UIViewController {
    
    func openChat(with user: CometChat.User) {
        let messagesVC = CometChatMessages()
        messagesVC.user = user
        
        // Smart replies appear automatically in the composer
        // when enabled in dashboard
        
        navigationController?.pushViewController(messagesVC, animated: true)
    }
}

Conversation Summary

AI generates summaries of long conversations so users can catch up quickly.

How It Works

User opens a conversation with many messages
User taps the summary option in composer action sheet
AI processes the conversation
Summary of key points is displayed

Implementation

Conversation summary is available automatically:

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

class ChatViewController: UIViewController {
    
    func openChat(with user: CometChat.User) {
        let messagesVC = CometChatMessages()
        messagesVC.user = user
        
        // Conversation summary option appears in composer action sheet
        // when enabled in dashboard and sufficient messages exist
        
        navigationController?.pushViewController(messagesVC, animated: true)
    }
}

AI Assistant Chat History

View and continue conversations with AI assistants.

Basic Implementation

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

class AIAssistantViewController: UIViewController {
    
    var user: CometChat.User!
    
    func showAIChatHistory() {
        let chatHistory = CometChatAIAssistanceChatHistory()
        chatHistory.user = user  // Required
        
        navigationController?.pushViewController(chatHistory, animated: true)
    }
}

Full Implementation with Callbacks

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

class AIAssistantViewController: UIViewController {
    
    var user: CometChat.User!
    
    func showAIChatHistory() {
        let chatHistory = CometChatAIAssistanceChatHistory()
        chatHistory.user = user
        
        // Handle new chat button
        chatHistory.onNewChatButtonClicked = { [weak self] in
            self?.startNewAIChat()
        }
        
        // Handle message tap
        chatHistory.onMessageClicked = { message in
            print("Tapped message: \(message.text ?? "")")
        }
        
        // Handle load success
        chatHistory.set(onLoad: { messages in
            print("Loaded \(messages.count) AI messages")
        })
        
        // Handle empty state
        chatHistory.set(onEmpty: {
            print("No AI chat history")
        })
        
        // Handle errors
        chatHistory.set(onError: { [weak self] error in
            self?.showError(error.localizedDescription)
        })
        
        navigationController?.pushViewController(chatHistory, animated: true)
    }
    
    private func startNewAIChat() {
        // Navigate to new AI chat
        print("Starting new AI conversation")
    }
    
    private func showError(_ message: String) {
        let alert = UIAlertController(title: "Error", message: message, preferredStyle: .alert)
        alert.addAction(UIAlertAction(title: "OK", style: .default))
        present(alert, animated: true)
    }
}

Customize AI Chat History Styling

Swift

import UIKit
import CometChatUIKitSwift

class AIAssistantViewController: UIViewController {
    
    var user: CometChat.User!
    
    func showStyledAIChatHistory() {
        let chatHistory = CometChatAIAssistanceChatHistory()
        chatHistory.user = user
        
        // Custom styling
        let style = AiAssistantChatHistoryStyle()
        style.backgroundColor = .systemBackground
        style.itemTextFont = UIFont.systemFont(ofSize: 16, weight: .medium)
        style.itemTextColor = .label
        style.newChatTitleFont = UIFont.systemFont(ofSize: 18, weight: .bold)
        style.newChatTitleColor = .systemBlue
        chatHistory.style = style
        
        // Custom empty state
        chatHistory.emptyStateText = "No AI conversations yet"
        chatHistory.emptyStateSubtitleText = "Tap 'New Chat' to start"
        
        // Custom date formatting
        chatHistory.dateTimeFormatter.today = { timestamp in
            let date = Date(timeIntervalSince1970: TimeInterval(timestamp))
            let formatter = DateFormatter()
            formatter.timeStyle = .short
            return "Today at \(formatter.string(from: date))"
        }
        
        navigationController?.pushViewController(chatHistory, animated: true)
    }
}

Complete App with AI Features

Full implementation showing all AI features:

Swift

import UIKit
import CometChatUIKitSwift
import CometChatSDK

// MARK: - Scene Delegate
class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    
    var window: UIWindow?
    
    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        guard let windowScene = (scene as? UIWindowScene) else { return }
        
        let uikitSettings = UIKitSettings()
            .set(appID: "YOUR_APP_ID")
            .set(authKey: "YOUR_AUTH_KEY")
            .set(region: "YOUR_REGION")
            .subscribePresenceForAllUsers()
            .build()
        
        CometChatUIKit.init(uiKitSettings: uikitSettings) { [weak self] result in
            switch result {
            case .success:
                CometChatUIKit.login(uid: "cometchat-uid-1") { loginResult in
                    switch loginResult {
                    case .success:
                        DispatchQueue.main.async {
                            self?.setupUI(windowScene: windowScene)
                        }
                    case .onError(let error):
                        print("Login failed: \(error.description)")
                    @unknown default:
                        break
                    }
                }
            case .failure(let error):
                print("Init failed: \(error.localizedDescription)")
            }
        }
    }
    
    private func setupUI(windowScene: UIWindowScene) {
        let tabBar = AIEnabledTabBarController()
        window = UIWindow(windowScene: windowScene)
        window?.rootViewController = tabBar
        window?.makeKeyAndVisible()
    }
}

// MARK: - Tab Bar Controller
class AIEnabledTabBarController: UITabBarController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupTabs()
    }
    
    private func setupTabs() {
        // Chats - AI features (starters, smart replies, summary) work automatically
        let chatsVC = CometChatConversationsWithMessages()
        let chatsNav = UINavigationController(rootViewController: chatsVC)
        chatsNav.tabBarItem = UITabBarItem(
            title: "Chats",
            image: UIImage(systemName: "message"),
            selectedImage: UIImage(systemName: "message.fill")
        )
        
        // AI Assistant
        let aiVC = AIAssistantListViewController()
        let aiNav = UINavigationController(rootViewController: aiVC)
        aiNav.tabBarItem = UITabBarItem(
            title: "AI Assistant",
            image: UIImage(systemName: "sparkles"),
            selectedImage: UIImage(systemName: "sparkles")
        )
        
        // Users
        let usersVC = CometChatUsersWithMessages()
        let usersNav = UINavigationController(rootViewController: usersVC)
        usersNav.tabBarItem = UITabBarItem(
            title: "Users",
            image: UIImage(systemName: "person.2"),
            selectedImage: UIImage(systemName: "person.2.fill")
        )
        
        viewControllers = [chatsNav, aiNav, usersNav]
    }
}

// MARK: - AI Assistant List
class AIAssistantListViewController: UIViewController {
    
    private let tableView = UITableView()
    private var users: [CometChat.User] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        title = "AI Assistant"
        setupTableView()
        fetchUsers()
    }
    
    private func setupTableView() {
        view.addSubview(tableView)
        tableView.frame = view.bounds
        tableView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        tableView.delegate = self
        tableView.dataSource = self
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: "cell")
    }
    
    private func fetchUsers() {
        let request = UsersRequest.UsersRequestBuilder()
            .set(limit: 30)
            .build()
        
        request.fetchNext { [weak self] users in
            self?.users = users
            DispatchQueue.main.async {
                self?.tableView.reloadData()
            }
        } onError: { error in
            print("Error: \(error?.errorDescription ?? "")")
        }
    }
}

extension AIAssistantListViewController: UITableViewDelegate, UITableViewDataSource {
    
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return users.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath)
        let user = users[indexPath.row]
        cell.textLabel?.text = user.name
        cell.accessoryType = .disclosureIndicator
        return cell
    }
    
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        tableView.deselectRow(at: indexPath, animated: true)
        
        let user = users[indexPath.row]
        let chatHistory = CometChatAIAssistanceChatHistory()
        chatHistory.user = user
        
        chatHistory.onNewChatButtonClicked = { [weak self] in
            // Start new AI chat
            let messagesVC = CometChatMessages()
            messagesVC.user = user
            self?.navigationController?.pushViewController(messagesVC, animated: true)
        }
        
        navigationController?.pushViewController(chatHistory, animated: true)
    }
}

Troubleshooting

Problem	Solution
AI features not appearing	Enable them in CometChat Dashboard → AI
Conversation starters not showing	Only appear for new conversations with no messages
Smart replies not appearing	Ensure feature is enabled and messages exist
Summary not generating	Need sufficient messages in conversation
AI Assistant empty	Verify user has AI chat history

AI Assistant Chat History - Full component documentation
Message List - Where conversation starters appear
Message Composer - Where smart replies appear
Conversation Starter Guide - Platform configuration
Smart Replies Guide - Platform configuration

​Overview

​Enable AI Features

​Conversation Starters

​How It Works

​Implementation

​Smart Replies

​How It Works

​Implementation

​Conversation Summary

​How It Works

​Implementation

​AI Assistant Chat History

​Basic Implementation

​Full Implementation with Callbacks

​Customize AI Chat History Styling

​Complete App with AI Features

​Troubleshooting

​Related

Overview

Enable AI Features

Conversation Starters

How It Works

Implementation

Smart Replies

How It Works

Implementation

Conversation Summary

How It Works

Implementation

AI Assistant Chat History

Basic Implementation

Full Implementation with Callbacks

Customize AI Chat History Styling

Complete App with AI Features

Troubleshooting

Related