whatsapp-watcher

Monitor WhatsApp Web chats and create Needs_Action markdown files for urgent keywords.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE --skill whatsapp-watcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whatsapp-watcher
Source: https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE/tree/main/.qwen/skills/whatsapp-watcher
Command: npx skills add https://github.com/akbarfarooq2006/Hackathon0_Digital_FTE --skill whatsapp-watcher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) components.

What problem does it solve?

This Skill monitors WhatsApp Web for unread messages and keyword hits, and automatically creates action files in Needs_Action/ to trigger human-in-the-loop workflows.

Core Features & Use Cases

  • Automatically detects unread WhatsApp messages and keywords.
  • Generates structured action files in the Vault's Needs_Action/ ready for processing by the MVP pipeline.
  • Supports prioritization via keyword matches and integrates with HITL approval workflows.

Quick Start

From the .qwen/skills/whatsapp-watcher directory, run the watcher against your Obsidian vault to begin monitoring WhatsApp Web.

Frequently Asked Questions about whatsapp-watcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor WhatsApp Web for urgent messages and create action items?

You can monitor WhatsApp Web for urgent messages using Playwright-based automation to scan chats for keywords like urgent, asap, and invoice. It identifies unread messages and automatically generates structured markdown action files in the vault's Needs_Action directory for processing.

What are needs_action entries and how do they work with WhatsApp monitoring?

Needs_Action entries are structured markdown files generated in your vault when the watcher detects specific keywords or unread chats on WhatsApp Web. These files are designed to trigger human-in-the-loop workflows and be processed by the MVP pipeline for high-priority task triage.

Do I need Playwright to automate WhatsApp Web message tracking?

Yes, Playwright is a required dependency for this WhatsApp monitoring task. It provides the browser automation framework needed to maintain persistent sessions on WhatsApp Web and programmatically scan incoming chats for priority keywords.

Can I integrate WhatsApp chat monitoring with an Obsidian vault?

Yes, the watcher integrates directly with an Obsidian vault by writing markdown action files into the Needs_Action folder. This allows you to capture urgent WhatsApp messages and process them alongside your existing notes and human-in-the-loop approval workflows.

What is the best way to flag urgent WhatsApp messages for human-in-the-loop approval?

The best way to flag urgent WhatsApp messages is to use automated keyword matching for terms like help and payment, which then generates high-priority action files. This approach directly integrates with HITL workflows to ensure critical chats are reviewed and approved.

Why does WhatsApp Web monitoring require a persistent browser session?

WhatsApp Web monitoring requires a persistent browser session because Playwright needs to maintain an authenticated state to continuously access and scan incoming chats. Without a persistent session, the automation would lose its connection and fail to detect real-time unread messages.