From 75805cf1cf7a75a09e3d5f53ea54a3678892806e Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 21 May 2026 18:27:02 +0530 Subject: [PATCH 1/4] 44399 --- moderation/lists-management.mdx | 46 ++++++++++++++++++++++++++++----- 1 file changed, 39 insertions(+), 7 deletions(-) diff --git a/moderation/lists-management.mdx b/moderation/lists-management.mdx index baba04722..20b7b6419 100644 --- a/moderation/lists-management.mdx +++ b/moderation/lists-management.mdx @@ -41,16 +41,27 @@ Create a custom keyword list in under 2 minutes: - Profanity and offensive terms - Brand names or competitors - Industry-specific blocked terms - - **Example:** `badword, offensive, blocked` + + **Entry format:** Comma-separated. Add multiple keywords on the same line, separated by commas. + + **Example:** + ``` + badword, offensive, blocked + ``` Regular expression matching for complex patterns. Use for: - Phone number formats - Email patterns - Custom data formats - - **Example:** `\b\d{3}[-.]?\d{3}[-.]?\d{4}\b` (US phone numbers) + + **Entry format:** Newline-separated — one regex pattern per line. Commas are treated as literal characters inside a pattern, so do **not** comma-separate multiple patterns on the same line. + + **Example:** + ``` + \b\d{3}[-.]?\d{3}[-.]?\d{4}\b + [A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,} + ``` **Greedy Regex Not Allowed:** For system performance and security, greedy regex patterns (using `*`, `+`, `{n,}` without proper boundaries) are not permitted. Greedy patterns can cause excessive backtracking and impact system performance. @@ -72,11 +83,30 @@ Create a custom keyword list in under 2 minutes: - Scam message variations - Platform circumvention attempts - Context-aware blocking - - **Example:** "Send me your credit card details" will match similar phishing attempts + + **Entry format:** Newline-separated — one sentence or phrase per line. + + **Example:** + ``` + Send me your credit card details + What is your bank account number + Share your OTP with me + ``` + +**Entry format at a glance** + +| List type | Format | Separator | +| --- | --- | --- | +| Keywords | Comma-separated | `,` | +| Patterns (Regex) | Newline-separated | New line | +| Sentence Similarity | Newline-separated | New line | + +If you paste comma-separated values into a Patterns or Sentence Similarity list, the entire string is stored as a single entry and will not match as expected. + + --- ## Default Lists Summary @@ -176,7 +206,9 @@ Pre-configured lists ready to use with your rules: - **ID**: Unique identifier - **Category**: Word, Pattern, or Sentence Similarity - **Description**: Purpose of the list - - **Source**: Enter terms manually (comma-separated) or upload CSV + - **Source**: Enter terms manually or upload CSV. Format depends on the category: + - **Word**: comma-separated entries. + - **Pattern** and **Sentence Similarity**: one entry per line (newline-separated). 3. Click **Save** ### List All Lists From e6aa4f7ea78616ac57c5bfbd1e5ebc6ae4f6a48b Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 21 May 2026 18:33:37 +0530 Subject: [PATCH 2/4] 44414 --- docs.json | 1 + sdk/javascript/webhooks.mdx | 67 +++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+) create mode 100644 sdk/javascript/webhooks.mdx diff --git a/docs.json b/docs.json index 36108e721..172825868 100644 --- a/docs.json +++ b/docs.json @@ -3057,6 +3057,7 @@ "sdk/javascript/ai-moderation", "sdk/javascript/ai-agents", "sdk/javascript/ai-copilot", + "sdk/javascript/webhooks", { "group": "Resources", "pages": [ diff --git a/sdk/javascript/webhooks.mdx b/sdk/javascript/webhooks.mdx new file mode 100644 index 000000000..ae3b4a614 --- /dev/null +++ b/sdk/javascript/webhooks.mdx @@ -0,0 +1,67 @@ +--- +title: "Webhooks" +description: "Webhooks — CometChat documentation." +--- + + + +CometChat can send webhook events that notify your application any time an event happens on your account. + +## Setting up webhooks + +### Create a webhook endpoint + +Webhook data is sent as JSON in the POST request body. Creating a webhook endpoint on your server is no different from creating any page on your website. With PHP, you might create a new .php file on your server; with a Ruby framework like Sinatra, you would add a new route with the desired URL. + +### Test the endpoint locally + +Once you’ve added an endpoint to your server, start an instance locally and use a tool like [ngrok](https://ngrok.com) to make your endpoint available for receiving events. + +Start ngrok in a command prompt with the same port number that you have configured for your server (e.g., ./ngrok http 8000). You should see information about your tunnel session such as status, expiration, and version. Take note of the Forwarding addresses (e.g., [https://xxxxxxxx.ngrok.io](https://xxxxxxxx.ngrok.io) -> localhost:8000) as this is required for the following step. + +### Configure webhook settings + +With your endpoint created, you need to tell CometChat about where to send events to. In the Dashboard's Webhooks section, click **Create Webhook** to reveal a form to add a new webhook for receiving events. You can enter any URL as the destination for events. However, this should be a dedicated page on your server that is set up to receive webhook events. + +Once you've created the webhook, click **View/Update** to add a trigger. We support two types of triggers- + +| Trigger | Description | +| --------------- | ----------------------------------------------------------- | +| after\_message | The endpoint will be triggered after a message is sent. | +| before\_message | The endpoint will be triggered when a message is in-flight. | + +The `after_message` trigger is fairly straightforward. CometChat will call your endpoint once a message has been sent. + +The `before_message` trigger is useful when you want to add metadata to a message before it reaches the recipient. The data you return will be automatically added to the message metadata: + + + +```json +{ +"@injected": { + "webhooks": { + "webhook-id": { + // JSON Object Response From Endpoint + } + } +} +} +``` + + + + + +You can also decide to drop a message by returning the following JSON object- + + + +```json +{ +"action": "do_not_propagate" +} +``` + + + + From 74bed02b1e50d69fa11eb093e38469e36c02e54d Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 21 May 2026 18:36:51 +0530 Subject: [PATCH 3/4] 44551 --- notifications/logs.mdx | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/notifications/logs.mdx b/notifications/logs.mdx index b108d8299..79d90fef1 100644 --- a/notifications/logs.mdx +++ b/notifications/logs.mdx @@ -26,5 +26,15 @@ Logs are kept for up to 14 days: 7 days while logging is active, plus 7 days aft ### Access and filtering -- **Dashboard:** Browse recent logs and narrow by channel, event, user, or status. +- **Dashboard:** Browse recent logs and narrow them down using any of the following filters: + - **Channel** — push, email, or SMS. + - **Event** — message sent, edited, deleted, reaction, group membership change, etc. + - **Sender (User)** — filter by the UID that triggered the notification. + - **Receiver Type** — `user` (one-on-one) or `group`. + - **Receiver ID** — the UID or GUID that should receive the notification. + - **Status** — sent, failed, skipped, etc. - **API:** Use the Get logs API with query parameters (event, medium, receiver, status, time window, provider) for deeper filtering. See the [API explorer](/rest-api/chat-apis) for the full list. + + +**Receiver ID filter requires Receiver Type.** When filtering by Receiver ID in the dashboard, first select a **Receiver Type** (user or group), then enter the Receiver ID. Using Receiver ID without selecting Receiver Type first will not return results. We are tracking this requirement and plan to make Receiver ID work standalone in a future release. + From 46c7852f9e43f3dcd3135a6e1b6fa741beeff467 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 21 May 2026 18:44:22 +0530 Subject: [PATCH 4/4] 44386 --- ai-agents/agent-builder/overview.mdx | 4 ++++ ui-kit/android/guide-ai-agent.mdx | 4 ++++ ui-kit/android/v6/guide-ai-agent.mdx | 4 ++++ ui-kit/flutter/v5/guide-message-agentic-flow.mdx | 4 ++++ ui-kit/ios/guide-ai-agent.mdx | 4 ++++ ui-kit/react-native/guide-ai-agent.mdx | 4 ++++ ui-kit/react/ai-assistant-chat.mdx | 4 ++++ 7 files changed, 28 insertions(+) diff --git a/ai-agents/agent-builder/overview.mdx b/ai-agents/agent-builder/overview.mdx index 9776f7c0b..00a166161 100644 --- a/ai-agents/agent-builder/overview.mdx +++ b/ai-agents/agent-builder/overview.mdx @@ -15,6 +15,10 @@ description: "Create, configure, and launch AI agents directly inside CometChat. 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. + +**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). + + ## Getting Started ### How to create an agent – step-by-step guide diff --git a/ui-kit/android/guide-ai-agent.mdx b/ui-kit/android/guide-ai-agent.mdx index 10dc1220b..357d9dc96 100644 --- a/ui-kit/android/guide-ai-agent.mdx +++ b/ui-kit/android/guide-ai-agent.mdx @@ -25,6 +25,10 @@ Enable intelligent conversational AI capabilities in your Android app using Come Transform your chat experience with AI-powered assistance that provides intelligent responses and offers seamless integration with your existing chat infrastructure. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + ## Overview Users can interact with AI agents through a dedicated chat interface that: diff --git a/ui-kit/android/v6/guide-ai-agent.mdx b/ui-kit/android/v6/guide-ai-agent.mdx index 2da496105..856abac5c 100644 --- a/ui-kit/android/v6/guide-ai-agent.mdx +++ b/ui-kit/android/v6/guide-ai-agent.mdx @@ -25,6 +25,10 @@ Enable intelligent conversational AI capabilities in your Android app using Come Transform your chat experience with AI-powered assistance that provides intelligent responses and seamless integration with your existing chat infrastructure. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + ## Overview Users can interact with AI agents through a dedicated chat interface that: diff --git a/ui-kit/flutter/v5/guide-message-agentic-flow.mdx b/ui-kit/flutter/v5/guide-message-agentic-flow.mdx index 6a160f371..b6ad03950 100644 --- a/ui-kit/flutter/v5/guide-message-agentic-flow.mdx +++ b/ui-kit/flutter/v5/guide-message-agentic-flow.mdx @@ -19,6 +19,10 @@ description: "Integrate AI agents with chat history, contextual responses, and s AI Agent Integration enables intelligent conversational AI capabilities with chat history, contextual responses, and seamless handoffs. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + Before starting, complete the [Getting Started](/ui-kit/flutter/v5/getting-started) guide. --- diff --git a/ui-kit/ios/guide-ai-agent.mdx b/ui-kit/ios/guide-ai-agent.mdx index 5f27b32ef..96c5127c8 100644 --- a/ui-kit/ios/guide-ai-agent.mdx +++ b/ui-kit/ios/guide-ai-agent.mdx @@ -6,6 +6,10 @@ description: "Add AI-powered chat assistants to your iOS app" Integrate AI agents into your iOS app to provide intelligent conversational experiences with chat history, contextual responses, and seamless handoffs. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + diff --git a/ui-kit/react-native/guide-ai-agent.mdx b/ui-kit/react-native/guide-ai-agent.mdx index 200657a38..a902c4ad7 100644 --- a/ui-kit/react-native/guide-ai-agent.mdx +++ b/ui-kit/react-native/guide-ai-agent.mdx @@ -27,6 +27,10 @@ Enable intelligent conversational AI capabilities in your React Native app using Transform your chat experience with AI-powered assistance that provides intelligent responses and offers seamless integration with your existing chat infrastructure. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + ## Overview Users can interact with AI agents through a dedicated chat interface that: diff --git a/ui-kit/react/ai-assistant-chat.mdx b/ui-kit/react/ai-assistant-chat.mdx index 6055d1d25..50b37fbea 100644 --- a/ui-kit/react/ai-assistant-chat.mdx +++ b/ui-kit/react/ai-assistant-chat.mdx @@ -54,6 +54,10 @@ description: "Composite AI agent chat with streaming responses, quick suggestion `CometChatAIAssistantChat` is a standalone AI chat panel. It composes an internal message header, message list, and message composer into a self-contained AI conversation experience. It requires a `CometChat.User` representing the AI agent. + +**1:1 conversations only.** AI Agents currently respond only in one-on-one conversations between an end user and the agent user. They do not respond to messages sent in groups, even if the agent user is added as a member or owner. Group support is on the roadmap — share your use case on [feedback.cometchat.com](https://feedback.cometchat.com). + + ```tsx lines import { useState, useEffect } from "react"; import { CometChat } from "@cometchat/chat-sdk-javascript";