wa-multi-mongodb 3.9.7 → 3.9.9

package/dist/Messaging/index.d.ts

@@ -1,6 +1,17 @@
 import { proto } from "baileys";
-import { SendMediaTypes, SendMessageTypes, SendReadTypes, SendTypingTypes } from "../Types";
+import { SendMediaTypes, SendMessageTypes, SendReadTypes, SendTypingTypes, SendMessageWithMentionTypes } from "../Types";
 export declare const sendTextMessage: ({ sessionId, to, text, isGroup, ...props }: SendMessageTypes) => Promise<proto.WebMessageInfo | undefined>;
+/**
+ * Kirim pesan teks dengan mention
+ *
+ * @param sessionId - ID sesi WhatsApp
+ * @param to - Nomor telepon atau JID tujuan
+ * @param text - Teks pesan (bisa mengandung @nomor untuk mention)
+ * @param mentions - Array JID yang akan di-mention
+ * @param isGroup - Apakah ini adalah grup
+ * @param props - Properti tambahan seperti answering
+ */
+export declare const sendTextMessageWithMention: ({ sessionId, to, text, mentions, isGroup, ...props }: SendMessageWithMentionTypes) => Promise<proto.WebMessageInfo | undefined>;
 export declare const sendMedia: ({ sessionId, to, media, type, caption, fileName, isGroup, answering, }: SendMediaTypes) => Promise<proto.WebMessageInfo | undefined>;
 export declare const sendVoiceNote: ({ sessionId, to, isGroup, media, ...props }: Omit<SendMediaTypes, "text">) => Promise<proto.WebMessageInfo | undefined>;
 export declare const sendSticker: ({ sessionId, to, isGroup, media, ...props }: SendMediaTypes) => Promise<proto.WebMessageInfo | undefined>;

package/dist/Messaging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Messaging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,SAAS,CAAC;AAGnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EAChB,MAAM,UAAU,CAAC;AAOlB,eAAO,MAAM,eAAe,GAAU,4CAMnC,gBAAgB,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CA2H7D,CAAC;AAaF,eAAO,MAAM,SAAS,GAAU,wEAS7B,cAAc,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAgL3D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,6CAMjC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CA2GzE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,6CAM/B,cAAc,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAyG3D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAU,uCAK9B,eAAe,KAAG,OAAO,CAAC,IAAI,CAuEhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAU,qBAG/B,aAAa,KAAG,OAAO,CAAC,IAAI,CA6B9B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAU,qBAGjC,aAAa,KAAG,OAAO,CAAC,IAAI,CAsC9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Messaging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,SAAS,CAAC;AAGnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAOlB,eAAO,MAAM,eAAe,GAAU,4CAMnC,gBAAgB,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CA2H7D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,GAAU,sDAO9C,2BAA2B,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAiJxE,CAAC;AAaF,eAAO,MAAM,SAAS,GAAU,wEAS7B,cAAc,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAgL3D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAU,6CAMjC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CA2GzE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,6CAM/B,cAAc,KAAG,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAyG3D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAU,uCAK9B,eAAe,KAAG,OAAO,CAAC,IAAI,CAuEhC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAU,qBAG/B,aAAa,KAAG,OAAO,CAAC,IAAI,CA6B9B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAU,qBAGjC,aAAa,KAAG,OAAO,CAAC,IAAI,CAsC9B,CAAC"}

package/dist/Messaging/index.js

@@ -23,7 +23,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteMessage = exports.readMessage = exports.sendTyping = exports.sendSticker = exports.sendVoiceNote = exports.sendMedia = exports.sendTextMessage = void 0;
+exports.deleteMessage = exports.readMessage = exports.sendTyping = exports.sendSticker = exports.sendVoiceNote = exports.sendMedia = exports.sendTextMessageWithMention = exports.sendTextMessage = void 0;
 const Defaults_1 = require("../Defaults");
 const Socket_1 = require("../Socket");
 const Utils_1 = require("../Utils");
@@ -126,6 +126,127 @@ const sendTextMessage = (_a) => __awaiter(void 0, void 0, void 0, function* () {
     return attemptSend();
 });
 exports.sendTextMessage = sendTextMessage;
+/**
+ * Kirim pesan teks dengan mention
+ *
+ * @param sessionId - ID sesi WhatsApp
+ * @param to - Nomor telepon atau JID tujuan
+ * @param text - Teks pesan (bisa mengandung @nomor untuk mention)
+ * @param mentions - Array JID yang akan di-mention
+ * @param isGroup - Apakah ini adalah grup
+ * @param props - Properti tambahan seperti answering
+ */
+const sendTextMessageWithMention = (_a) => __awaiter(void 0, void 0, void 0, function* () {
+    var { sessionId, to, text = "", mentions = [], isGroup = false } = _a, props = __rest(_a, ["sessionId", "to", "text", "mentions", "isGroup"]);
+    const session = (0, Socket_1.getSession)(sessionId);
+    if (!session)
+        throw new Error_1.WhatsappError(Defaults_1.Messages.sessionNotFound(sessionId));
+    // Deteksi otomatis apakah ini adalah grup berdasarkan format JID
+    const toStr = to.toString();
+    const isGroupChat = toStr.includes('@g.us');
+    // Jika sudah dalam format grup, gunakan to langsung
+    // Jika tidak, gunakan phoneToJid untuk mengkonversi ke format yang benar
+    let jid;
+    if (isGroupChat) {
+        if (!toStr.endsWith('@g.us')) {
+            jid = toStr + '@g.us';
+        }
+        else {
+            jid = toStr;
+        }
+    }
+    else {
+        jid = (0, Utils_1.phoneToJid)({ to, isGroup: isGroup || isGroupChat });
+    }
+    let retryCount = 0;
+    const maxRetries = 3;
+    const attemptSend = () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c;
+        try {
+            // Gunakan flag force untuk mencoba memaksa pengiriman pesan bahkan jika koneksi tidak stabil
+            const messageOptions = {
+                quoted: props.answering,
+            };
+            // Konfirmasi sekali lagi apakah ini grup berdasarkan format JID setelah konversi
+            const isDestinationGroup = jid.endsWith('@g.us');
+            // Gunakan waktu jeda untuk memastikan koneksi siap
+            yield (0, create_delay_1.createDelay)(500);
+            // Beri timeout yang lebih pendek untuk grup untuk mencegah hanging
+            const timeoutMs = isDestinationGroup ? 15000 : 30000;
+            // Persiapkan pesan dengan mention jika ada
+            const messageContent = {
+                text: text,
+            };
+            // Tambahkan mentions jika ada
+            if (mentions && mentions.length > 0) {
+                messageContent.mentions = mentions;
+            }
+            // Gunakan withTimeout untuk membatasi waktu operasi
+            return yield (0, create_delay_1.withTimeout)(session.sendMessage(jid, messageContent, messageOptions), timeoutMs, `Pengiriman pesan dengan mention ke ${jid} melebihi batas waktu ${timeoutMs / 1000} detik`);
+        }
+        catch (error) {
+            console.error(`Error saat mengirim pesan dengan mention (percobaan ${retryCount + 1}/${maxRetries}): ${(error === null || error === void 0 ? void 0 : error.message) || 'Unknown error'}`);
+            // Jika error terkait MessageCounterError (grup dengan channel pengumuman)
+            if (((_a = error === null || error === void 0 ? void 0 : error.message) === null || _a === void 0 ? void 0 : _a.includes('MessageCounterError')) || ((_b = error === null || error === void 0 ? void 0 : error.stack) === null || _b === void 0 ? void 0 : _b.includes('MessageCounterError'))) {
+                console.warn('Terdeteksi MessageCounterError, kemungkinan grup dengan channel pengumuman');
+                if (retryCount < maxRetries) {
+                    retryCount++;
+                    // Tambahkan delay lebih lama antara percobaan
+                    yield (0, create_delay_1.createDelay)(2000 * retryCount);
+                    console.log(`Mencoba kembali pengiriman pesan dengan mention (${retryCount}/${maxRetries})...`);
+                    return attemptSend();
+                }
+                else {
+                    console.error('Batas maksimum percobaan ulang tercapai');
+                    throw new Error_1.WhatsappError(`Gagal mengirim pesan dengan mention ke grup dengan channel pengumuman setelah ${maxRetries} kali percobaan`);
+                }
+            }
+            // Jika koneksi tertutup, coba reconnect
+            if ((_c = error === null || error === void 0 ? void 0 : error.message) === null || _c === void 0 ? void 0 : _c.includes('Connection Closed')) {
+                try {
+                    yield (0, Socket_1.reconnect)(sessionId);
+                    yield (0, create_delay_1.createDelay)(3000); // Beri waktu untuk reconnect sepenuhnya
+                    // Persiapkan pesan dengan mention untuk reconnect
+                    const messageContent = {
+                        text: text,
+                    };
+                    if (mentions && mentions.length > 0) {
+                        messageContent.mentions = mentions;
+                    }
+                    // Coba kirim lagi setelah reconnect
+                    return yield (0, create_delay_1.withTimeout)(session.sendMessage(jid, messageContent, {
+                        quoted: props.answering,
+                    }), 30000, `Pengiriman pesan dengan mention setelah reconnect melebihi batas waktu`);
+                }
+                catch (reconnectError) {
+                    console.error(`Gagal reconnect: ${(reconnectError === null || reconnectError === void 0 ? void 0 : reconnectError.message) || 'Unknown error'}`);
+                    throw new Error_1.WhatsappError(`Koneksi terputus dan gagal reconnect: ${(reconnectError === null || reconnectError === void 0 ? void 0 : reconnectError.message) || 'Unknown error'}`);
+                }
+            }
+            // Jika ada error timeout atau error lain, coba lagi sekali dengan delay lebih lama
+            try {
+                yield (0, create_delay_1.createDelay)(2000);
+                // Persiapkan pesan dengan mention untuk percobaan kedua
+                const messageContent = {
+                    text: text,
+                };
+                if (mentions && mentions.length > 0) {
+                    messageContent.mentions = mentions;
+                }
+                // Untuk percobaan kedua, gunakan timeout yang lebih lama
+                return yield (0, create_delay_1.withTimeout)(session.sendMessage(jid, messageContent, {
+                    quoted: props.answering,
+                }), 20000, `Percobaan kedua pengiriman pesan dengan mention melebihi batas waktu`);
+            }
+            catch (retryError) {
+                console.error(`Gagal pada percobaan kedua: ${(retryError === null || retryError === void 0 ? void 0 : retryError.message) || 'Unknown error'}`);
+                throw new Error_1.WhatsappError(`Gagal mengirim pesan dengan mention: ${(retryError === null || retryError === void 0 ? void 0 : retryError.message) || 'Unknown error'}`);
+            }
+        }
+    });
+    return attemptSend();
+});
+exports.sendTextMessageWithMention = sendTextMessageWithMention;
 const sendMedia = (_a) => __awaiter(void 0, [_a], void 0, function* ({ sessionId, to, media, type, caption = "", fileName, isGroup = false, answering, }) {
     const session = (0, Socket_1.getSession)(sessionId);
     if (!session)

package/dist/Types/index.d.ts

@@ -6,6 +6,9 @@ export interface SendMessageTypes {
     isGroup?: boolean;
     answering?: proto.IWebMessageInfo;
 }
+export interface SendMessageWithMentionTypes extends SendMessageTypes {
+    mentions?: string[];
+}
 export interface SendMediaTypes extends SendMessageTypes {
     media: string | Buffer;
     type: "image" | "video" | "audio" | "pdf" | "xls" | "xlsx" | "doc" | "docx" | "zip" | "mp3";

package/dist/Types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,eAAe;IAC5D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAGvC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,CAAC;CACd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,eAAe;IAC5D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAGvC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IACvD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iCAAiC;IAChD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,CAAC;CACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wa-multi-mongodb",
-  "version": "3.9.7",
+  "version": "3.9.9",
   "description": "Multi Session Whatsapp Library with MongoDB Integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
     "@types/node-cache": "^4.1.3",
     "@types/qrcode": "^1.5.5",
     "aws4": "^1.13.2",
-    "baileys": "github:WhiskeySockets/Baileys#next",
+    "baileys": "^6.7.20",
     "dotenv": "^16.5.0",
     "link-preview-js": "^3.0.14",
     "mime": "^3.0.0",

package/readme.md

@@ -248,9 +248,51 @@ function autoDeleteMessage(sessionId, message, delayMs = 3000) {
   }, delayMs);
 }
 
-// Usage: Auto-delete a sent message after 5 seconds
-const sentMsg = await whatsapp.sendTextMessage({/*...*/});
-autoDeleteMessage("mysession", sentMsg, 5000);
+// Send text message with mention (v3.9.8+)
+// Mention one user in a group
+await whatsapp.sendTextMessageWithMention({
+  sessionId: "mysession",
+  to: "6281234567890@g.us", // group JID
+  text: "Halo @6281234567890, selamat datang di grup!",
+  mentions: ["6281234567890@s.whatsapp.net"], // JID to mention
+  isGroup: true
+});
+
+// Mention multiple users in a group
+await whatsapp.sendTextMessageWithMention({
+  sessionId: "mysession",
+  to: "6281234567890@g.us",
+  text: "Halo @6281234567890 dan @6289876543210, ada yang bisa saya bantu?",
+  mentions: [
+    "6281234567890@s.whatsapp.net",
+    "6289876543210@s.whatsapp.net"
+  ],
+  isGroup: true
+});
+
+// Mention in private chat (less common but supported)
+await whatsapp.sendTextMessageWithMention({
+  sessionId: "mysession",
+  to: "6281234567890",
+  text: "Halo @6281234567890, ini adalah pesan pribadi dengan mention",
+  mentions: ["6281234567890@s.whatsapp.net"]
+});
+
+// Alternative: Use sendTextMessage with mentions property
+// You can also use the regular sendTextMessage with mentions
+const session = whatsapp.getSession("mysession");
+if (session) {
+  await session.sendMessage(
+    "6281234567890@g.us",
+    {
+      text: "Halo @6281234567890, ini pesan dengan mention!",
+      mentions: ["6281234567890@s.whatsapp.net"]
+    },
+    {
+      quoted: null // or message to quote
+    }
+  );
+}
 ```
 
 ### Event Listeners
@@ -764,6 +806,7 @@ export default WhatsAppQRComponent;
 5. **Announcement Channels**: Groups with announcement channels may trigger `MessageCounterError` (handled automatically in v3.9.1+)
 6. **Retry Strategy**: For announcement channel groups, the library will automatically retry sending messages up to 3 times with increasing delays
 7. **Group Metadata Caching**: Use the hybrid caching system (v3.9.4+) to improve performance when working with groups
+8. **New `sendTextMessageWithMention` Function**: Comprehensive mention functionality for WhatsApp messages (v3.9.8+)
 
 ## WhatsApp Limitations
 
@@ -773,7 +816,17 @@ export default WhatsAppQRComponent;
 
 ## Changelog
 
-### v3.9.7 (latest)
+### v3.9.8 (latest)
+### Added
+- **New `sendTextMessageWithMention` Function**: Comprehensive mention functionality for WhatsApp messages
+  - Support for mentioning single or multiple users in group chats
+  - Automatic JID format validation and conversion
+  - Full retry mechanism with error handling for mention messages
+  - Support for quoted messages with mentions
+  - Compatible with both group and private chat mentions
+  - Enhanced timeout handling for mention messages
+
+### v3.9.7
 - **Enhanced Message Processing for Group Chats**: Fixed issues with group message handling and improved message processing architecture
   - **Multiple Message Processing**: Event handler `messages.upsert` now processes all messages in array instead of only the first message
   - **Improved Message Filtering**: Added intelligent filtering to skip protocol messages and empty messages while preserving valid group messages