cometchat · raj-dubey1 · Jul 9, 2026 · Jul 9, 2026 · Jul 9, 2026 · Jul 9, 2026
diff --git a/ai-agents.mdx b/ai-agents.mdx
@@ -67,7 +67,7 @@ Because CometChat AI Agents are model-agnostic, you can swap providers or upgrad
           </p>
           <div className="mt-4 flex flex-wrap gap-3">
             <a
-              href="/docs/ai-agents/agent-builder/overview"
+              href="/ai-agents/agent-builder/overview"
               className="inline-flex items-center justify-center rounded-full bg-gray-900 text-white px-5 py-2 text-sm font-medium hover:bg-gray-800 transition"
             >
               AI Agent Builder
@@ -84,7 +84,7 @@ Because CometChat AI Agents are model-agnostic, you can swap providers or upgrad
           </p>
           <div className="mt-4 flex flex-wrap gap-3">
             <a
-              href="/docs/ai-agents/ag-ui"
+              href="/ai-agents/ag-ui"
               className="inline-flex items-center justify-center rounded-full bg-gray-900 text-white px-5 py-2 text-sm font-medium hover:bg-gray-800 transition"
             >
               Connect Third-Party Agent
@@ -100,8 +100,8 @@ Because CometChat AI Agents are model-agnostic, you can swap providers or upgrad
       <p className="text-gray-600 dark:text-gray-300">Create and manage frontend actions and tools to enhance your agent’s capabilities.</p>
 
       <div className="flex flex-wrap gap-3 mt-4">
-        <a href="/docs/ai-agents/actions" className="inline-flex items-center gap-1 px-4 py-2 rounded-md border border-gray-300 dark:border-gray-600 text-sm font-medium hover:bg-gray-50 dark:hover:bg-gray-800" target="_blank">Get Started with Actions ↗</a>
-        <a href="/docs/ai-agents/tools" className="inline-flex items-center gap-1 px-4 py-2 rounded-md border border-gray-300 dark:border-gray-600 text-sm font-medium hover:bg-gray-50 dark:hover:bg-gray-800" target="_blank">Get Started with Tools ↗</a>
+        <a href="/ai-agents/actions" className="inline-flex items-center gap-1 px-4 py-2 rounded-md border border-gray-300 dark:border-gray-600 text-sm font-medium hover:bg-gray-50 dark:hover:bg-gray-800" target="_blank">Get Started with Actions ↗</a>
+        <a href="/ai-agents/tools" className="inline-flex items-center gap-1 px-4 py-2 rounded-md border border-gray-300 dark:border-gray-600 text-sm font-medium hover:bg-gray-50 dark:hover:bg-gray-800" target="_blank">Get Started with Tools ↗</a>
       </div>
       <p className="text-gray-500 text-sm mt-3">Actions: trigger UI & workflows. Tools: structured capabilities the agent can call.</p>
     </Step> */}

diff --git a/ai-agents/agent-builder/overview.mdx b/ai-agents/agent-builder/overview.mdx
@@ -13,7 +13,7 @@

 ## Overview

 Agent Builder provides the capability to create, configure, and customize AI agents directly within CometChat. It supports selecting models, integrating ready-to-use tools, APIs, and MCPs, and deploying agents without relying on any external management or orchestration platforms.

 <Note>
 **Where AI Agents respond.** Agents created in Agent Builder respond only in one-on-one conversations between an end user and the agent user. They do not respond when added to a group, even as a member or owner. If your use case requires an agent in group conversations, share your requirements on [feedback.cometchat.com](https://feedback.cometchat.com).
@@ -49,7 +49,7 @@
 
   <Step title="Configure the agent" description="Set up capabilities.">
     <p className="text-gray-600 dark:text-gray-300">
-      After creation, configure instructions, tools, and MCPs from the left-hand tabs. Detailed guidance lives in the <a href="/docs/ai-agents/agent-builder/instructions">Instructions</a>, <a href="/docs/ai-agents/agent-builder/tools/overview">Tools</a>, and <a href="/docs/ai-agents/agent-builder/mcp/overview">MCP</a> sections.
+      After creation, configure instructions, tools, and MCPs from the left-hand tabs. Detailed guidance lives in the <a href="/ai-agents/agent-builder/instructions">Instructions</a>, <a href="/ai-agents/agent-builder/tools/overview">Tools</a>, and <a href="/ai-agents/agent-builder/mcp/overview">MCP</a> sections.
     </p>
   </Step>
 
@@ -61,7 +61,7 @@
 - Instructions define how your agent behaves, what it knows, and how it should respond. Use them to set tone, outline guardrails, and describe hand-off rules. 
 - The instructions editor supports `@` mentions so you can reference specific tools and MCP resources inline—this gives the agent unambiguous guidance about when to invoke each capability.

 ### Tools and MCPs
 - Attach tools for deterministic actions (custom APIs, Google Suite, or other integrations) and link MCP endpoints for richer context. 
 - You can embed any of these capabilities directly inside instructions using the `@` menu, ensuring the agent knows exactly when and how to rely on them.


diff --git a/articles/migration-guide.mdx b/articles/migration-guide.mdx
@@ -12,11 +12,11 @@
 3. [Make the API changes](/articles/migration-guide#rest-api-changes-) (Applicable if you are using CometChat Rest APIs)
 4. Mark the migration process as complete in the dashboard. We recommend 30 days to complete the migration process

 After you begin the migration process, there's a window of time during which your production application will be compatible with both v2 and v3 SDKs and APIs.

 During this phase, real-time events (receipts, typing indicator, live reactions, transient messages, and user presence indicators) won’t work cross-version. This means that users with clients using the old v2 SDK won’t get real-time events from users on clients supporting the new v3 SDK, and vice-versa. However, receipts and presence information are still updated in our database, so they'll still be available when fetched via the API.

 After you finish making any required changes to your application and mark the migration as complete, your app will only be compatible with v3 SDKs and APIs. Provided all clients have been updated to v3, all real-time events will be supported once more.

 Marking the migration as finished is left to your discretion; however, we strongly recommend that after initiating migration, you complete your changes and finish the migration within **30 days**.

@@ -47,7 +47,7 @@

 ### Chat Widgets

 ### UI Kits and SDKs

 JavaScript: [Upgrading from v2](/sdk/javascript/3.0/resources-upgrading-from-v2)

@@ -57,7 +57,7 @@
 
 React Native: [Upgrading from v2](/sdk/react-native/3.0/resources-upgrading-from-v2)
 
-Ionic Cordova Capacitor: [Upgrading from v2](/sdk/ionic-legacy/3.0/resources-upgrading-from-v2)
+Ionic Cordova Capacitor: [Upgrading from v2](https://assets.cometchat.io/legacy-docs/sdk/ionic-legacy/3.0/resources-upgrading-from-v2.html)
 
 _Note: if you mark your migration as complete without following the specified upgrade guide fully, your application may become stuck in a broken state, with out-of-sync SDK / API and application versions unable to communicate properly. If this happens, contact support._
 
@@ -96,7 +96,7 @@

 3. How much effort does it take?

 4. - Per app just the code changes should not take more than 30 mins.

 5. How can I ask for help if I am stuck at some stage?
   - You can reach out to our customer support team for such queries.

diff --git a/calls/flutter/setup.mdx b/calls/flutter/setup.mdx
@@ -13,7 +13,7 @@
 - Call buttons with one-tap calling
 - Call logs with history
 
-👉 [Flutter UI Kit Calling Integration](/ui-kit/flutter/calling-integration)
+👉 [Flutter UI Kit Calling Integration](/ui-kit/flutter/v5/calling-integration)
 
 Use this Calls SDK directly only if you need custom call UI or advanced control.
 </Info>
@@ -74,7 +74,7 @@

 ## Initialize CometChat Calls

 The `init()` method initializes the SDK with your app credentials. Call this method once when your application starts, typically in your `main()` function or root widget's `initState()`.

 ### CallAppSettingBuilder


diff --git a/chat-call.mdx b/chat-call.mdx
@@ -1,7 +1,7 @@
 ---
 mode: "custom"
 title: "Chat & Messaging"
 description: "Add real-time chat, voice & video calling to your apps in minutes. Choose your path: UI Kits, SDKs, or Widgets."
 canonical: "https://cometchat.com/docs"
 ---

@@ -57,7 +57,7 @@

 <div className="mb-12">
    <h2 className="text-gray-700 dark:text-white text-2xl font-semibold">Add CometChat to Your Frontend</h2>
    <p className="text-gray-600 dark:text-gray-300">Use our pre-built UI kits or SDKs to add chat to your website or mobile app instantly.</p>
 </div>

 {/* UI Kit Builder Section */}
@@ -167,7 +167,7 @@
  </CardGroup>
 </div>

 {/* SDKs Section */}

 <div className="mb-12">
  <h3 className="text-xl font-semibold text-gray-700 dark:text-white mb-4">
@@ -212,7 +212,7 @@
     <Card title="iOS" icon={<img src="/docs/images/icons/swift.svg" alt="iOS" />} href="/sdk/ios/overview" horizontal />
     <Card title="Android" icon={<img src="/docs/images/icons/android.svg" alt="Android" />} href="/sdk/android/overview" horizontal />
     <Card title="Flutter" icon={<img src="/docs/images/icons/flutter.svg" alt="Flutter" />} href="/sdk/flutter/overview" horizontal />
-    <Card title="Ionic" icon={<img src="/docs/images/icons/ionic.svg" alt="Ionic" />} href="/sdk/ionic/overview" horizontal />
+    <Card title="Ionic" icon={<img src="/docs/images/icons/ionic.svg" alt="Ionic" />} href="/sdk/ionic-legacy/overview" horizontal />
     <Card title="Unreal Engine" icon={<img src="/docs/images/icons/unreal.svg" alt="Unreal Engine" />} href="/sdk/unreal/overview" horizontal />
   </CardGroup>
 </div>
@@ -259,7 +259,7 @@

  <CardGroup cols={2}>
  <Card
    title="HTML / Bootstrap / jQuery"
    icon={<img src="/docs/images/icons/html5.svg" alt="HTML / Bootstrap / jQuery" />}
    href="/widget/html/integration"
    horizontal

diff --git a/fundamentals/extensions-overview.mdx b/fundamentals/extensions-overview.mdx
@@ -66,11 +66,11 @@ Extensions that help you add support to your app. *Recommended for advanced apps
 Extensions that help alert users of new messages. *Recommended for all apps.*
 
 [Push Notification](/notifications/web-push-notifications)\
-[Email Notification](/notifications/email-notifications-extension-legacy)\
-[SMS Notification](/notifications/sms-notifications-extension-legacy)
+[Email Notification](https://assets.cometchat.io/legacy-docs/notifications/email-notifications-extension-legacy.html)\
+[SMS Notification](https://assets.cometchat.io/legacy-docs/notifications/sms-notifications-extension-legacy.html)
 
 ### Moderation
 
 *Extensions that help you to build a safe messaging environment.* *Recommended for live streaming and event apps.*
 
-[Legacy Moderation Extensions](/moderation/legacy-extensions)
+[Legacy Moderation Extensions](https://assets.cometchat.io/legacy-docs/moderation/legacy-extensions.html)
diff --git a/fundamentals/moderation-extensions.mdx b/fundamentals/moderation-extensions.mdx
@@ -7,6 +7,6 @@ CometChat Moderation features come in two variants:
 
 1. The modern rule based [Moderation](/moderation/overview) platform.
 
-2. The [Legacy Moderation Extensions](/moderation/legacy-extensions) based on CometChat Extensions.
+2. The [Legacy Moderation Extensions](https://assets.cometchat.io/legacy-docs/moderation/legacy-extensions.html) based on CometChat Extensions.
 
 For the best experience, we recommend using the rule based [Moderation](/moderation/overview) platform.
diff --git a/images/01a6f1df-1633625271-66d7d5dd85f4470c655d902bf7fa85bd.png b/images/01a6f1df-1633625271-66d7d5dd85f4470c655d902bf7fa85bd.png
diff --git a/images/0380f9ce-1640937733-db13c95c4dba1700cb3e9ad7016fb18c.png b/images/0380f9ce-1640937733-db13c95c4dba1700cb3e9ad7016fb18c.png
diff --git a/images/0b8820c9-1640937745-015a5fd67f1185d1b2d0272be3252a06.png b/images/0b8820c9-1640937745-015a5fd67f1185d1b2d0272be3252a06.png
diff --git a/images/2465097e-1640937784-595c3a354a910eaf3e93a4c732160e96.png b/images/2465097e-1640937784-595c3a354a910eaf3e93a4c732160e96.png
diff --git a/images/94bd7567-1640937759-985854eaa68734ab4ea0d63ac667fb1f.png b/images/94bd7567-1640937759-985854eaa68734ab4ea0d63ac667fb1f.png
diff --git a/images/97122883-1640937720-fcd19d0ec4b22be8309cbad8172e611e.png b/images/97122883-1640937720-fcd19d0ec4b22be8309cbad8172e611e.png
diff --git a/...bqx44d29hd6mdtxoxbxtfeucz7rs3kebgmn5xg7nh7-3873961b1475ec06f951cae9d679b0f3.png b/...bqx44d29hd6mdtxoxbxtfeucz7rs3kebgmn5xg7nh7-3873961b1475ec06f951cae9d679b0f3.png
diff --git a/images/ce087489-1640937807-2c55cbabbfcbae49896063810822240d.png b/images/ce087489-1640937807-2c55cbabbfcbae49896063810822240d.png
diff --git a/images/cef182e1-1640937699-59eddd83a6c0783b06ccf5eebe3b7d94.png b/images/cef182e1-1640937699-59eddd83a6c0783b06ccf5eebe3b7d94.png
@@ -6,7 +6,7 @@
 The Moderation feature provides a comprehensive suite of capabilities designed to manage and enforce message moderation rules across various types of messages, ensuring your platform remains safe and compliant for all users.
 
 <Note>
-**Using legacy moderation extensions?** Disable legacy extensions (Profanity Filter, Data Masking, Image Moderation) from the [Extensions page](/moderation/legacy-extensions) before creating moderation rules. Running both will cause performance issues and message delays as each message gets processed twice.
+**Using legacy moderation extensions?** Disable legacy extensions (Profanity Filter, Data Masking, Image Moderation) from the [Extensions page](https://assets.cometchat.io/legacy-docs/moderation/legacy-extensions.html) before creating moderation rules. Running both will cause performance issues and message delays as each message gets processed twice.
 </Note>
 
 ## Key Benefits
@@ -67,9 +67,9 @@
  <Card title="Angular" icon={<img src="/docs/images/icons/angular.svg" alt="Angular" />} href="/ui-kit/angular/core-features#moderation" />
 </CardGroup>

 ### Chat SDKs

 Implement message flagging directly using CometChat Chat SDKs:

 <CardGroup cols={3}>
  <Card title="JavaScript" icon={<img src="/docs/images/icons/js.svg" alt="JavaScript" />} href="/sdk/javascript/ai-moderation" />
@@ -147,22 +147,22 @@
    | **Explicit or Sexual Content** | Identifies nudity, explicit sexual content, or suggestive imagery |
    | **Hate or Harassment** | Detects hate symbols, harassment, or extremist imagery |
    | **Fraud or Scam Indicators** | Flags manipulated or fraudulent images, such as fake IDs |
    | **Malware & Virus Scanner** | Scans image files for viruses, malware, trojans, worms, and ransomware |
  </Tab>
  <Tab title="Video Rules">
    | Name | Description |
    |------|-------------|
    | **Unsafe & Prohibited Content** | Detects unsafe or prohibited content in video files |
    | **Malware & Virus Scanner** | Scans video files for viruses, malware, trojans, worms, and ransomware |
  </Tab>
  <Tab title="Audio Rules">
    | Name | Description |
    |------|-------------|
    | **Malware & Virus Scanner** | Scans audio files for viruses, malware, trojans, worms, and ransomware |
  </Tab>
  <Tab title="File Rules">
    | Name | Description |
    |------|-------------|
    | **Malware & Virus Scanner** | Scans all file attachments (documents, archives, etc.) for viruses, malware, trojans, worms, and ransomware |
  </Tab>
 </Tabs>
@@ -10,18 +10,18 @@ Notifications play a crucial role in alerting users to activity within conversat
 Deliver instant updates and improve user engagement. CometChat has the following offerings.
 
 * [Push Notifications](/notifications/push-overview)
-* [Push Notifications extension (Legacy)](/notifications/push-notifications-extension-legacy)
+* [Push Notifications extension (Legacy)](https://assets.cometchat.io/legacy-docs/notifications/push-notifications-extension-legacy.html)
 
 ### Email Notifications
 
 Dispatch updates at intervals to re-engage users with extended absence using Emails.
 
 * [Email Notifications](/notifications/email-overview)
-* [Email Notifications extension (Legacy)](/notifications/email-notifications-extension-legacy).
+* [Email Notifications extension (Legacy)](https://assets.cometchat.io/legacy-docs/notifications/email-notifications-extension-legacy.html).
 
 ### SMS Notifications
 
 Dispatch updates at intervals to re-engage users with extended absence using SMS.
 
 * [SMS Notifications](/notifications/sms-overview)
-* [SMS Notifications extension (Legacy)](/notifications/sms-notifications-extension-legacy).
+* [SMS Notifications extension (Legacy)](https://assets.cometchat.io/legacy-docs/notifications/sms-notifications-extension-legacy.html).
@@ -14,8 +14,8 @@ Extensions pickup where our core leaves. They help extend the functionality of C
 Extensions that help alert users of new messages. *Recommended for all apps.*
 
 [Push Notification](/notifications/android-push-notifications)\
-[Email Notification](/notifications/email-notifications-extension-legacy)\
-[SMS Notification](/notifications/sms-notifications-extension-legacy)
+[Email Notification](https://assets.cometchat.io/legacy-docs/notifications/email-notifications-extension-legacy.html)\
+[SMS Notification](https://assets.cometchat.io/legacy-docs/notifications/sms-notifications-extension-legacy.html)
 
 ### User Experience
 
@@ -50,4 +50,4 @@ Extensions that help increase user engagement. *Recommended for advanced apps.*
 
 *Extensions that help you to build a safe messaging environment.* *Recommended for live streaming and event apps.*
 
-[Legacy Moderation Extensions](/moderation/legacy-extensions)
+[Legacy Moderation Extensions](https://assets.cometchat.io/legacy-docs/moderation/legacy-extensions.html)
@@ -1,10 +1,10 @@
 ---
 title: "AI Chatbots"
 sidebarTitle: "AI Chatbots"
 description: "Implement custom AI chatbots for automated conversations in your Android application"
-url: "/ai-chatbots/overview"
+url: "https://assets.cometchat.io/legacy-docs/ai-chatbots/ai-bots/overview.html"
 ---
 
 AI Chatbots enable automated conversations within your application. They can process user messages and respond with contextually relevant information. For a broader introduction, see the [AI Chatbots section](/ai-chatbots).

 For message payload structures (AIAssistantMessage, AIToolArgumentMessage, AIToolResultMessage), see the [AI Agents](/sdk/android/ai-agents#agentic-message-payload-structures) page.
@@ -1,4 +1,4 @@
 ---
 title: "AI"
-url: "/ai-chatbots/overview"
+url: "https://assets.cometchat.io/legacy-docs/ai-chatbots/ai-bots/overview.html"
 ---
@@ -1,5 +1,5 @@
 ---
 title: "Bots"
 description: "Build AI chatbots for Flutter apps with CometChat to automate replies, assist users, and connect bot workflows to chat."
-url: "/ai-chatbots/overview"
+url: "https://assets.cometchat.io/legacy-docs/ai-chatbots/ai-bots/overview.html"
 ---
@@ -10,7 +10,7 @@
 
 ## Send Message in a Thread
 
-As mentioned in the [Send a Message](send-message) section, you can send a message to a User or a Group by mentioning the receiver (uid/guid) and `receiverType`(user/group).
+As mentioned in the [Send a Message](/sdk/flutter/send-message) section, you can send a message to a User or a Group by mentioning the receiver (uid/guid) and `receiverType`(user/group).
 
 A message can be categorized as:
 
@@ -29,20 +29,20 @@
 <Tab title="Dart">
 ```dart
 String receiverID = "UID";
 String messagesText = "Hello";
 String receiverType = CometChatConversationType.user;
 String type = CometChatMessageType.text;

 TextMessage textMessage = TextMessage(
                        text: messagesText,
                        receiverUid: receiverID,
                        receiverType: receiverType,
                        type: type);
 textMessage.parentMessageId = 103

 CometChat.sendMessage(textMessage,onSuccess: (TextMessage message) {
 debugPrint("Message sent successfully:  $message");
 }, onError: (CometChatException e) {
 debugPrint("Message sending failed with exception:  ${e.message}");
 });
 ```
@@ -56,7 +56,7 @@
 
 ### Receiving Real-Time Messages
 
-The procedure to receive real-time messages is exactly the same as mentioned in the [Receive Messages](receive-messages). This can be achieved using the `MessageListener` class provided by the SDK.
+The procedure to receive real-time messages is exactly the same as mentioned in the [Receive Messages](/sdk/flutter/receive-messages). This can be achieved using the `MessageListener` class provided by the SDK.
 To add a MessageListener, you can use the `addMessageListener()` method of the SDK.
 The only thing that needs to be checked is if the received message belongs to the active thread. This can be done using `parentMessageId` field of the message object.
 
@@ -99,7 +99,7 @@

 The `MessageRequestBuilder` builds the `MessageRequest` object using the following functions:

 1. parentMessageId: Takes the parentId of the message as argument whose thread needs to be requested.
 2. build(): returns the MessageRequest object.

 Once you have the `MessagesRequest` object, you can call the `fetchPrevious()` method to get the latest messages in the thread. In one iteration, a maximum of 100 messages can be fetched. If you wish to fetch the next set of messages, you need to call the fetchPrevious() method again on the same object.
@@ -109,14 +109,14 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..parentMessageId = 103
          ..limit = 50).build();

 messageRequest.fetchPrevious(onSuccess: (List<BaseMessage> list) {
         debugPrint("Message fetching Successful");
      }, onError: (CometChatException e) {
        debugPrint("Message fetching failed with exception: ${e.message}");
      });
 ```

@@ -96,7 +96,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..limit = 30).build();
 ```
@@ -134,7 +134,7 @@
 <Tab title="Dart">
 ```dart
 String GUID = "cometchat-uid-1";
 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..guid = GUID
          ..limit = 50).build();   
 ```
@@ -158,7 +158,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..messageId = 50
          ..limit = 50).build();
@@ -204,7 +204,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..unread = true
          ..limit = 50).build();
@@ -250,7 +250,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..updatedAfter = DateTime.now()
          ..limit = 50).build();
@@ -288,7 +288,7 @@
 
 *In other words, how do I fetch messages belonging to multiple categories*
 
-We recommend before trying this, you refer to the [Message structure and hierarchy guide](/sdk/flutter/message-structure-and-hierarchy) to get familiar with the various categories of messages.
+We recommend before trying this, you refer to the [Message structure and hierarchy guide](/sdk/flutter/v4/message-structure-and-hierarchy) to get familiar with the various categories of messages.
 
 Use the `categories` property with a list of category names to filter by message category.
 
@@ -300,7 +300,7 @@
 categories.add("message");
 categories.add("custom");

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..categories = categories
          ..limit = 50).build();
@@ -316,7 +316,7 @@
 
 *In other words, how do I fetch messages belonging to multiple types*
 
-We recommend you refer to the [Message structure and hierarchy guide](/sdk/flutter/message-structure-and-hierarchy) to get familiar with the various types of messages before trying this out.
+We recommend you refer to the [Message structure and hierarchy guide](/sdk/flutter/v4/message-structure-and-hierarchy) to get familiar with the various types of messages before trying this out.
 
 Use the `types` property with a list of type names to filter by message type.
 
@@ -351,7 +351,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..parentMessageId = 103
          ..limit = 50).build();
@@ -395,7 +395,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..hideDeleted = true
          ..limit = 50).build();
@@ -440,7 +440,7 @@
 tags.add("tag1");
 tags.add("tag2");

 MessagesRequest messageRequest = (MessagesRequestBuilder()
          ..uid = UID
          ..tags = tags
          ..limit = 50).build();
@@ -494,7 +494,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
  ..uid = UID
  ..hasLinks = true
  ..limit = 50).build();
@@ -548,7 +548,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
  ..uid = UID
  ..hasReactions = true
  ..limit = 50).build();
@@ -589,7 +589,7 @@

 *In other words, as a logged-in user, how do I fetch messages that mention specific users?*

 Use the `mentionedUids` property with a list of UIDs to fetch messages that mention specific users.

 <Note>

@@ -601,9 +601,9 @@
 <Tab title="Dart">
 ```dart
 String UID = "cometchat-uid-1";
 List<String> mentionedUIDs = [];
 mentionedUIDs.add("cometchat-uid-1");
 MessagesRequest messageRequest = (MessagesRequestBuilder()
  ..uid = UID
  ..mentionedUids = mentionedUIDs
  ..limit = 50).build();
@@ -630,7 +630,7 @@
 ```dart
 String UID = "cometchat-uid-1";

 MessagesRequest messageRequest = (MessagesRequestBuilder()
  ..uid = UID
  ..attachmentTypes = ["image", "video"]
  ..limit = 50).build();
@@ -651,7 +651,7 @@
   <Card title="Retrieve Conversations" icon="comments" href="/sdk/flutter/retrieve-conversations">
     Fetch and display conversation lists with filtering options
   </Card>
-  <Card title="Message Structure" icon="sitemap" href="/sdk/flutter/message-structure-and-hierarchy">
+  <Card title="Message Structure" icon="sitemap" href="/sdk/flutter/v4/message-structure-and-hierarchy">
     Understand message categories, types, and hierarchy
   </Card>
   <Card title="Threaded Messages" icon="layer-group" href="/sdk/flutter/threaded-messages">

@@ -1,8 +1,8 @@
 ---
 title: "Bots"
 sidebarTitle: "AI Bots"
 description: "Configure AI-powered chatbots to provide automated assistance and maintain conversational momentum in your Flutter app."
-url: "/ai-chatbots/overview"
+url: "https://assets.cometchat.io/legacy-docs/ai-chatbots/ai-bots/overview.html"
 ---
 
 <Accordion title="AI Integration Quick Reference">
@@ -26,7 +26,7 @@

 </Accordion>

 AI Bots provide automated assistance to users seeking guidance or insights. Configure intelligent chatbots through the CometChat Dashboard to maintain conversational momentum in your Flutter application.

 <Note>
  **Available via:** [Dashboard](https://app.cometchat.com) | [REST

@@ -4,14 +4,14 @@
 description: "Recommended patterns and practices for building with the CometChat Flutter SDK."
 ---

 Follow these best practices to build reliable, performant, and secure applications with the CometChat Flutter SDK. Organized by topic — jump to what's relevant for your current work.

 ## Initialization & Authentication

 | Practice | Description |
 |----------|-------------|
 | Initialize once at startup | Call `CometChat.init()` in your `main()` or root widget's `initState()`. It only needs to be called once per session. |
 | Use environment variables | Store App ID, Region, and Auth Key in a config file or environment variables rather than hardcoding them. |
 | Check for existing sessions | Before calling `login()`, use `CometChat.getLoggedInUser()` to check if a session already exists. |
 | Use Auth Tokens in production | Auth Keys are for development only. Generate Auth Tokens server-side using the [REST API](https://api-explorer.cometchat.com/reference/create-authtoken). |
 | Handle token expiry | Implement a mechanism to detect login failures due to expired tokens. Use the [Login Listener](/sdk/flutter/authentication-overview#login-listener) to detect session changes. |
@@ -22,7 +22,7 @@
 | Practice | Description |
 |----------|-------------|
 | Use unique listener IDs | Use descriptive IDs like `"MESSAGE_LISTENER_CHAT_SCREEN"` to avoid accidental overwrites. |
 | Register early, remove on cleanup | Register listeners after `login()`. Remove them in your widget's `dispose()` method to prevent memory leaks. |
 | Keep callbacks lightweight | Avoid heavy processing inside listener callbacks. Use `setState()` or dispatch events to your state management layer. |
 | Use specific listeners | Only register the listener types you need. Don't register a `GroupListener` if your page only handles messages. |

@@ -71,7 +71,7 @@

 | Practice | Description |
 |----------|-------------|
 | Debounce typing events | Don't call `startTyping()` on every keystroke — debounce to ~300ms intervals. |
 | Auto-stop typing | Call `endTyping()` after 3–5 seconds of inactivity or when the user sends a message. |

 ## Delivery & Read Receipts
@@ -86,10 +86,10 @@

 | Practice | Description |
 |----------|-------------|
 | Use meaningful GUIDs | Choose descriptive, unique GUIDs (e.g., `"project-alpha-team"`). |
 | Set group type carefully | Group type cannot be changed after creation. Choose between `public`, `password`, and `private`. |
 | Add members at creation | Use `createGroupWithMembers()` to add initial members in a single API call. |
 | Check hasJoined before joining | Avoid unnecessary API calls by checking the group's `hasJoined` property first. |
 | Transfer ownership before leaving | Owners must transfer ownership to another member before they can leave. |
 | Use joinedOnly(true) | Filter to joined groups when building sidebars or group lists. |

@@ -128,12 +128,12 @@

 | Practice | Description |
 |----------|-------------|
 | iOS Podfile configuration | Run `pod install` in the `ios/` directory after adding the SDK dependency. Set the minimum iOS deployment target as required. |
 | Android minimum API level | Ensure `minSdkVersion` in `android/app/build.gradle` meets the SDK requirement. |
 | Use `dispose()` for cleanup | Always remove listeners and cancel subscriptions in your widget's `dispose()` method. |
 | Use `debugPrint` for logging | Prefer `debugPrint()` over `print()` for SDK-related logging — it handles long strings and is stripped in release builds. |
 | Handle platform exceptions | CometChat methods may throw `PlatformException` from native channels. Wrap calls in try/catch blocks. |
 | State management integration | Dispatch SDK events to your state management layer (Provider, Bloc, Riverpod) rather than calling `setState()` directly in listener callbacks. |

 ## Upgrading from V3

@@ -149,7 +149,7 @@
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Troubleshooting" icon="wrench" href="/sdk/flutter/troubleshooting">
+  <Card title="Troubleshooting" icon="wrench" href="/sdk/flutter/v4/troubleshooting">
     Common issues and solutions
   </Card>
   <Card title="Setup SDK" icon="gear" href="/sdk/flutter/setup">

@@ -59,7 +59,7 @@
 | Code | Message |
 |------|---------|
 | `COMETCHAT_INITIALIZATION_NOT_DONE` | Please initialize CometChat before using the login method. |
 | `USER_NOT_AUTHORISED` | The authToken of the user is not authorised. Please verify again. |
 | `AUTH_ERR_AUTH_TOKEN_NOT_FOUND` | The auth token does not exist. Please make sure you are logged in and have a valid auth token. |
 | `LOGIN_IN_PROGRESS` | Please wait until the previous login request ends. |
 | `WS_CONNECTION_FAIL` | WebSocket connection failed. |
@@ -86,8 +86,8 @@
 |------|---------|
 | `INVALID_RECEIVER_TYPE` | Receiver type can be `user` or `group`. |
 | `REQUEST_IN_PROGRESS` | Request in progress. |
 | `NOT_ENOUGH_PARAMETERS` | Timestamp, MessageId, or updatedAfter is required to use fetchNext(). |
 | `INVALID_REASON_ID` | Invalid reasonId provided. |

 ## User Errors

@@ -111,7 +111,7 @@
 | Code | Message |
 |------|---------|
 | `INVALID_CONVERSATION_TYPE` | Conversation type can be `user` or `group`. |
 | `CONVERSATION_NOT_FOUND` | Conversation not found. Check the value of conversationWith and conversationType. |

 ## Receipt Errors

@@ -152,8 +152,8 @@
 |------|---------|
 | `INVALID_PUSH_PLATFORM` | An invalid Push Platform was detected. Please submit a valid push platform to proceed. |
 | `INVALID_FCM_TOKEN` | An invalid FCM token was detected. Please submit a valid token to proceed. |
 | `INVALID_APNS_DEVICE_TOKEN` | An invalid APNs Device token was detected. Please submit a valid token to proceed. |
 | `INVALID_APNS_VOIP_TOKEN` | An invalid APNs VoIP token was detected. Please submit a valid token to proceed. |

 ## Network & API Errors

@@ -161,7 +161,7 @@
 |------|---------|
 | `FAILED_TO_FETCH` | There is an unknown issue with the API request. Check your internet connection. |
 | `TOO_MANY_REQUEST` | Too many requests. Wait before sending the next request. |
-| `ERR_TOO_MANY_REQUESTS` | Rate limiting. See [Rate Limits](/sdk/flutter/rate-limits). |
+| `ERR_TOO_MANY_REQUESTS` | Rate limiting. See [Rate Limits](/sdk/flutter/v4/rate-limits). |
 
 ## Validation Errors
 
@@ -180,9 +180,9 @@

 | Code | Message |
 |------|---------|
 | `ERROR_INVALID_SESSIONID` | The provided sessionId cannot be null or empty. |
 | `ERROR_INVALID_TYPE` | The provided type cannot be null or empty. |
 | `ERROR_INVALID_GROUPLIST` | Grouplist cannot be null or empty. |

 ## General Errors

@@ -219,16 +219,16 @@
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Troubleshooting" icon="wrench" href="/sdk/flutter/troubleshooting">
+  <Card title="Troubleshooting" icon="wrench" href="/sdk/flutter/v4/troubleshooting">
     Common issues and solutions
   </Card>
-  <Card title="Rate Limits" icon="gauge-high" href="/sdk/flutter/rate-limits">
+  <Card title="Rate Limits" icon="gauge-high" href="/sdk/flutter/v4/rate-limits">
     Understand and handle rate limits
   </Card>
   <Card title="Error Guide (REST API)" icon="triangle-exclamation" href="/articles/error-guide">
     Complete server-side error code reference
   </Card>
-  <Card title="Best Practices" icon="star" href="/sdk/flutter/best-practices">
+  <Card title="Best Practices" icon="star" href="/sdk/flutter/v4/best-practices">
     Recommended patterns for error handling
   </Card>
 </CardGroup>
@@ -135,7 +135,7 @@ For detailed information on each extension, including configuration options and
   <Card title="Webhooks" icon="webhook" href="/sdk/flutter/webhooks-overview">
     Configure webhooks for real-time event notifications
   </Card>
-  <Card title="Rate Limits" icon="gauge" href="/sdk/flutter/rate-limits">
+  <Card title="Rate Limits" icon="gauge" href="/sdk/flutter/v4/rate-limits">
     Understand API rate limits and quotas
   </Card>
   <Card title="Real-Time Listeners" icon="tower-broadcast" href="/sdk/flutter/real-time-listeners">

@@ -48,7 +48,7 @@
 |-----------|------|-------------|
 | `guid` | `String` | The GUID of the group to add members to |
 | `groupMembers` | `List<GroupMember>` | List of [GroupMember](/sdk/reference/entities#groupmember) objects (UID and scope required) |
 | `onSuccess` | `Function(Map<String?, String?>)` | Callback with a map of UIDs to result status |
 | `onError` | `Function(CometChatException)` | Callback triggered on failure |

 In order to add members, you need to create an object of the `GroupMember` class. The `UID` and the `scope` of the `GroupMember` are mandatory.
@@ -57,20 +57,20 @@
 <Tab title="Dart">
 ```dart
 List<GroupMember> groupMembers = [];
 GroupMember firstMember = GroupMember.fromUid(
 scope: CometChatMemberScope.participant,
 uid: "cometchat-uid-3",name: "name");
 GroupMember secondMember = GroupMember.fromUid(scope: CometChatMemberScope.admin,
 uid: "cometchat-uid-4",name: "name");

 groupMembers = [firstMember, secondMember];

 CometChat.addMembersToGroup( guid: conversationWith,
        groupMembers: groupMembers,
        onSuccess: (Map<String?,String?> result) {
          debugPrint("Group Member added Successfully : $result");
        },
        onError: (CometChatException e) {
          debugPrint("Group Member addition failed with exception: ${e.message}");
        });
 ```
@@ -163,7 +163,7 @@
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Kick & Ban Members" icon="user-slash" href="/sdk/flutter/group-kick-ban-members">
+  <Card title="Kick & Ban Members" icon="user-slash" href="/sdk/flutter/v4/group-kick-ban-members">
     Remove or ban members from a group
   </Card>
   <Card title="Change Member Scope" icon="user-shield" href="/sdk/flutter/group-change-member-scope">

@@ -40,11 +40,11 @@
 String GUID = "GUID";
 String scope = CometChatMemberScope.admin;

 CometChat.updateGroupMemberScope(guid: GUID, uid: UID, scope: scope,
        onSuccess: (String message) {
          debugPrint("Group Member Scope Changed Successfully : $message");
        },
        onError: (CometChatException e) {
          debugPrint("Group Member Scope Change failed : ${e.message}");
        });
 ```
@@ -139,7 +139,7 @@
   <Card title="Transfer Group Ownership" icon="arrow-right-arrow-left" href="/sdk/flutter/transfer-group-ownership">
     Transfer ownership of a group to another member
   </Card>
-  <Card title="Kick & Ban Members" icon="user-slash" href="/sdk/flutter/group-kick-ban-members">
+  <Card title="Kick & Ban Members" icon="user-slash" href="/sdk/flutter/v4/group-kick-ban-members">
     Remove or ban members from a group
   </Card>
   <Card title="Add Members" icon="user-plus" href="/sdk/flutter/group-add-members">

@@ -52,7 +52,7 @@ Groups let users converse together in a shared space. CometChat supports three g
 - [Retrieve Groups](/sdk/flutter/retrieve-groups) — Fetch and filter the list of groups
 - [Retrieve Group Members](/sdk/flutter/retrieve-group-members) — Get the member list for a group
 - [Add Members](/sdk/flutter/group-add-members) — Add users to a group
-- [Kick & Ban Members](/sdk/flutter/group-kick-ban-members) — Remove or ban members from a group
+- [Kick & Ban Members](/sdk/flutter/v4/group-kick-ban-members) — Remove or ban members from a group
 - [Change Member Scope](/sdk/flutter/group-change-member-scope) — Promote or demote members
 
 ---

@@ -62,7 +62,7 @@
 | `allowSenderInteraction` | `bool` | Whether sender can interact with the message | No (default: `false`) |
 | `interactionGoal` | `InteractionGoal` | Defines when the interaction is considered complete | No (default: `none`) |
 | `tags` | `List<String>` | Tags associated with the message | No |
 | `muid` | `String` | Unique message identifier for deduplication | No |
 | `parentMessageId` | `int` | ID of the parent message (for threads) | No |
 | `metadata` | `Map<String, dynamic>` | Custom metadata attached to the message | No |

@@ -132,9 +132,9 @@
      ]
    },
  ],
  "submitElement": {
    "elementType": "button",
    "elementId": "submitButton",
    "buttonText": "Submit",
    "disableAfterInteracted": false,
    "action": {
@@ -146,25 +146,25 @@



 InteractiveMessage interactiveMessage =
 InteractiveMessage(interactiveData: interactiveData,
                   receiverUid: "cometchat-uid-3", //Replace this with receiver id
                   type: "form",
                   receiverType: "user",//replace this with receiver type
                   allowSenderInteraction: true,
                   muid: DateTime.now().millisecondsSinceEpoch.toString(),
                   interactionGoal: InteractionGoal(
                     type: InteractionGoalType.none
                   )
                  );


 CometChat.sendInteractiveMessage(interactiveMessage, onSuccess: (InteractiveMessage message){

 print(interactiveMessage);

 }, onError: (CometChatException excep){
 print(excep);
 });
 ```

@@ -361,25 +361,25 @@
 <Tabs>
 <Tab title="Dart">
 ```dart
 List<String> elementIds = ["name", "gender", "submitButton"];
 InteractionGoal interactionGoal = InteractionGoal(
  type: InteractionGoalType.allOf,
  elementIds: elementIds,
 );

 InteractiveMessage interactiveMessage = InteractiveMessage(
  interactiveData: interactiveData,
  receiverUid: "cometchat-uid-3",
  type: "form",
  receiverType: "user",
  interactionGoal: interactionGoal,
 );

 CometChat.sendInteractiveMessage(interactiveMessage,
  onSuccess: (InteractiveMessage message) {
    debugPrint("Interactive message sent successfully: $message");
  },
  onError: (CometChatException excep) {
    debugPrint("Interactive message sending failed with error: ${excep.message}");
  },
 );
@@ -415,7 +415,7 @@
  await CometChat.markAsInteracted(
    messageId,
    interactedElementId,
    onSuccess: (String message) {
      // after success
    },
    onError: (CometChatException excep) {
@@ -538,11 +538,11 @@
 <Tabs>
 <Tab title="Dart">
 ```dart
 InteractiveMessage interactiveMessage = InteractiveMessage(
  interactiveData: interactiveData,
  receiverUid: "cometchat-uid-3",
  type: "form",
  receiverType: "user",
  allowSenderInteraction: true,
 );

@@ -550,7 +550,7 @@
  onSuccess: (InteractiveMessage message) {
    debugPrint("Interactive message sent successfully: $message");
  },
  onError: (CometChatException excep) {
    debugPrint("Interactive message sending failed with error: ${excep.message}");
  },
 );
@@ -573,7 +573,7 @@
   <Card title="Transient Messages" icon="ghost" href="/sdk/flutter/transient-messages">
     Send ephemeral messages that aren't stored
   </Card>
-  <Card title="Message Structure" icon="sitemap" href="/sdk/flutter/message-structure-and-hierarchy">
+  <Card title="Message Structure" icon="sitemap" href="/sdk/flutter/v4/message-structure-and-hierarchy">
     Understand message types and hierarchy
   </Card>
 </CardGroup>