@laburen/openclaw-plugin-whatsapp-api 0.3.1 → 0.5.0

package/index.js

@@ -97,9 +97,12 @@ const MIME_BY_EXT = {
 	".m4a": "audio/mp4",
 	".pdf": "application/pdf",
 	".txt": "text/plain",
+	".md": "text/markdown",
 	".csv": "text/csv",
 	".json": "application/json",
-	".zip": "application/zip"
+	".zip": "application/zip",
+	".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
 };
 function normalizeMime(value) {
 	const trimmed = value?.trim();
@@ -416,6 +419,48 @@ async function sendWhatsAppApiMedia(params) {
 		}
 	});
 }
+/**
+* Marks a message as read in the WhatsApp Cloud API.
+*
+* @param params.messageId - The WhatsApp message ID to mark as read
+* @param params.account - Resolved account for Graph auth
+* @returns Graph message id (usually just "unknown" or empty for read marks)
+*/
+async function sendWhatsAppApiReadMark(params) {
+	const { phoneNumberId, accessToken } = resolveGraphAuth(params.account);
+	return await sendWithRetry({
+		endpoint: `https://graph.facebook.com/${params.account.outboundApiVersion}/${phoneNumberId}/messages`,
+		account: params.account,
+		accessToken,
+		payload: {
+			messaging_product: "whatsapp",
+			status: "read",
+			message_id: params.messageId
+		}
+	});
+}
+/**
+* Shows/hides the typing indicator in the WhatsApp Cloud API.
+*
+* @param params.to - Recipient WhatsApp ID
+* @param params.typing - `true` for "typing_on", `false` for "typing_off"
+* @param params.account - Resolved account for Graph auth
+* @returns Graph message id
+*/
+async function sendWhatsAppApiTypingIndicator(params) {
+	const { phoneNumberId, accessToken } = resolveGraphAuth(params.account);
+	return await sendWithRetry({
+		endpoint: `https://graph.facebook.com/${params.account.outboundApiVersion}/${phoneNumberId}/messages`,
+		account: params.account,
+		accessToken,
+		payload: {
+			messaging_product: "whatsapp",
+			recipient_type: "individual",
+			to: normalizeRecipient(params.to),
+			sender_action: params.typing ? "typing_on" : "typing_off"
+		}
+	});
+}
 async function sendWhatsAppApiLocation(params) {
 	const { phoneNumberId, accessToken } = resolveGraphAuth(params.account);
 	return await sendWithRetry({
@@ -1178,9 +1223,33 @@ async function dispatchInboundToAgent(params) {
 		OriginatingTo: to
 	});
 	const dispatchFn = replyApi.dispatchReplyWithBufferedBlockDispatcher;
+	sendWhatsAppApiReadMark({
+		messageId: message.messageId,
+		account
+	}).catch((err) => log$3.warn("failed to mark read", {
+		error: String(err),
+		messageId: message.messageId
+	}));
 	await dispatchFn({
 		ctx: ctxPayload,
 		cfg,
+		typing: {
+			start: async () => {
+				await sendWhatsAppApiTypingIndicator({
+					to: message.from,
+					typing: true,
+					account
+				});
+			},
+			stop: async () => {
+				await sendWhatsAppApiTypingIndicator({
+					to: message.from,
+					typing: false,
+					account
+				});
+			},
+			onStartError: (err) => log$3.warn("failed to start typing", { error: String(err) })
+		},
 		dispatcherOptions: {
 			deliver: async (payload) => {
 				const account = resolveAccount(cfg, accountId);
@@ -1262,6 +1331,19 @@ function createWhatsAppApiChannel(api) {
 						account: resolveAccount(cfg, accountId ?? null)
 					})
 				};
+			},
+			sendMedia: async ({ to, mediaUrl, text, cfg, accountId }) => {
+				const account = resolveAccount(cfg, accountId ?? null);
+				return {
+					channel: CHANNEL_ID,
+					chatId: to,
+					messageId: await sendWhatsAppApiMedia({
+						to,
+						mediaUrl,
+						text: text || void 0,
+						account
+					})
+				};
 			}
 		},
 		gateway: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laburen/openclaw-plugin-whatsapp-api",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "type": "module",
   "description": "WhatsApp API channel plugin for OpenClaw",
   "main": "index.js",