Introduction
# WhatsApp Automation — Analyze Groups for Buying Signals
**Thousands of hidden leads are sitting in your WhatsApp groups right now.** Every group participant who isn't in your contacts is a potential client. MoltFlow analyzes your groups on demand, surfaces untapped contacts, and lets Claude run AI-powered outreach campaigns on your behalf.
**One skill. 90+ endpoints. Zero manual prospecting.**
> **Account Health & Growth Reports**: Run a read-only > account scan to find unanswered contacts, detect > buying signals in group conversations, spot high-value > groups you're not monitoring, and build targeted lead > lists. All analysis runs on-demand when you ask — > nothing happens in the background. No data is modified. > > **Native MCP Endpoint + Custom GPT Actions**: Works with Claude Desktop, Claude.ai, Claude Code, and ChatGPT (Custom GPT Actions). 25 tools via native HTTP endpoint at `apiv2.waiflow.app/mcp` -- no npm packages or Node.js required. See [integrations.md](integrations.md) for setup.
> ***Due to high demand and a recent registration issue, we're offering our top-tier Business plan with unlimited quotas for just $19.90/month on yearly billing — for a limited time only.*** [**Claim the deal**](https://buy.stripe.com/cNifZibX7gpQebJ0nsfnO00) > > Free tier available. [Sign up](https://molt.waiflow.app/checkout?plan=free)
---
## Just Ask Claude
Install the skill, set your API key, and tell Claude what you need:
**"Send a payment reminder to all clients with outstanding invoices on the 28th of each month"**
Creates a custom group, schedules a recurring message with cron, timezone-aware delivery.
**"Transcribe patient voice notes and save them as appointment summaries"**
Whisper transcription on incoming voice messages, retrievable via API.
**"Alert me when someone mentions 'budget', 'bedroom', or 'viewing' in my property groups"**
Keyword monitoring on WhatsApp groups, auto-creates leads in your pipeline.
**"Set up automatic order confirmation messages after every purchase"**
Webhook listener for purchase events, triggers outbound message via API.
**"Collect customer reviews after every reservation and export the best ones"**
Sentiment-scored review collection, auto-approve positives, export as HTML for your website.
**"Send a weekly campaign performance report to my team's WhatsApp group every Monday"**
Scheduled report with WhatsApp delivery, 10 templates including campaign analytics.
**"Schedule follow-up messages to leads who haven't replied in 3 days"**
Scheduled messages to custom groups, built from lead pipeline filters.
**"Broadcast class schedule changes to all parent groups"**
Bulk send to custom groups with ban-safe throttling and delivery tracking.
**"Auto-respond to support questions using my knowledge base docs"**
RAG-powered AI replies grounded in your uploaded PDFs and docs.
**"Move leads from 'new' to 'contacted' after I message them, and track conversion rate"**
CRM pipeline with state machine, bulk status updates, CSV export.
**"Export all data for a customer who requested GDPR erasure"**
GDPR-compliant data export and contact erasure via API.
**"Show me which campaigns had the best read rates this week"**
Campaign analytics with delivery funnel, per-contact status, and engagement scores.
---
## Code Samples
### Get campaign analytics — delivery rates, funnel, timing
```bash curl -H "X-API-Key: $MOLTFLOW_API_KEY" \ "https://apiv2.waiflow.app/api/v2/analytics/campaigns/{job_id}" ```
Returns delivery rate, failure breakdown, messages per minute, and full per-contact delivery status.
### Track delivery in real-time (SSE)
```bash curl -H "X-API-Key: $MOLTFLOW_API_KEY" \ "https://apiv2.waiflow.app/api/v2/bulk-send/{id}/progress" ```
Server-Sent Events stream: sent/failed/pending counts update live as each message delivers.
### Top contacts by engagement score
```bash curl -H "X-API-Key: $MOLTFLOW_API_KEY" \ "https://apiv2.waiflow.app/api/v2/analytics/contacts?sort=engagement_score&limit=50" ```
Ranked by messages sent, received, reply rate, and recency — find your most engaged contacts instantly.
### Bulk broadcast to a contact group
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "custom_group_id": "group-uuid", "session_id": "uuid", "message": "Weekly update..." }' \ https://apiv2.waiflow.app/api/v2/bulk-send ```
### Monitor a group for buying signals
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "session_id": "uuid", "wa_group_id": "[email protected]", "monitor_mode": "keywords", "monitor_keywords": ["looking for", "need help", "budget", "price"] }' \ https://apiv2.waiflow.app/api/v2/groups ```
### List new leads in your pipeline
```bash curl -H "X-API-Key: $MOLTFLOW_API_KEY" \ "https://apiv2.waiflow.app/api/v2/leads?status=new&limit=50" ```
### Move a lead through the pipeline
```bash curl -X PATCH -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{"status": "qualified"}' \ https://apiv2.waiflow.app/api/v2/leads/{lead_id}/status ```
Status flow: `new` → `contacted` → `qualified` → `converted` (or `lost` at any stage).
### Bulk add leads to a campaign group
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "lead_ids": ["uuid-1", "uuid-2", "uuid-3"], "custom_group_id": "target-group-uuid" }' \ https://apiv2.waiflow.app/api/v2/leads/bulk/add-to-group ```
### Export leads as CSV
```bash curl -H "X-API-Key: $MOLTFLOW_API_KEY" \ "https://apiv2.waiflow.app/api/v2/leads/export/csv?status=qualified" \ -o qualified-leads.csv ```
### Pause a running campaign
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ https://apiv2.waiflow.app/api/v2/bulk-send/{job_id}/pause ```
### AI reply in your writing style + knowledge base
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "contact_id": "[email protected]", "context": "Customer asks: What is your return policy?", "use_rag": true, "apply_style": true }' \ https://apiv2.waiflow.app/api/v2/ai/generate-reply ```
### Schedule a weekly follow-up
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Monday check-in", "session_id": "uuid", "chat_id": "[email protected]", "message": "Hey! Anything I can help with this week?", "recurrence": "weekly", "scheduled_time": "2026-03-03T09:00:00", "timezone": "America/New_York" }' \ https://apiv2.waiflow.app/api/v2/scheduled-messages ```
### Weekly report delivered to your WhatsApp
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Weekly Lead Pipeline", "template_id": "lead_pipeline", "schedule_type": "weekly", "cron_expression": "0 9 * * MON", "timezone": "America/New_York", "delivery_method": "whatsapp" }' \ https://apiv2.waiflow.app/api/v2/reports ```
### Send a message
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "session_id": "uuid", "chat_id": "[email protected]", "message": "Hello!" }' \ https://apiv2.waiflow.app/api/v2/messages/send ```
### Collect customer reviews automatically
```bash curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Happy Customers", "session_id": "uuid", "source_type": "all", "min_sentiment_score": 0.7, "include_keywords": ["thank", "recommend", "love", "amazing"] }' \ https://apiv2.waiflow.app/api/v2/reviews/collectors ```
### Discover A2A agents
```bash curl https://apiv2.waiflow.app/.well-known/agent.json ```
Full API reference: see each module's SKILL.md.
---
## ERC-8004 Agent Registration
MoltFlow is a verified on-chain AI agent registered on **Ethereum mainnet**.
| Field | Value | |-------|-------| | Agent ID | [#25477](https://8004agents.ai/ethereum/agent/25477) | | Chain | Ethereum mainnet (eip155:1) | | Registry | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | | Trust Model | Reputation-based | | Endpoints | A2A + MCP + Web |
**Discovery:** - Agent card: `https://molt.waiflow.app/.well-known/erc8004-agent.json` - A2A discovery: `https://apiv2.waiflow.app/.well-known/agent.json`
---
## Use Cases
**Solo Founder / Small Biz** - Find unanswered leads in your chats - AI replies in your writing style - Scheduled promos to custom groups
**Agency / Multi-Client** - Monitor 50+ groups across 10 sessions - Bulk send with ban-safe delays - Export leads as CSV, push to n8n/Zapier
**Marketing Agency / Campaign Manager** - Capture leads from click-to-WhatsApp ad campaigns - Auto-qualify inbound leads with keyword detection + AI scoring - Bulk follow-up sequences with ban-safe throttling - Multi-session management across client accounts - Export campaign leads to CRM via webhooks or CSV
**Developer / AI Agent Builder** - 90+ REST endpoints, scoped API keys - A2A protocol with E2E encryption - Python SDK: `pip install moltflow` ([GitHub](https://github.com/moltflow/moltflow-python))
### Guides & Tutorials
**AI Integration Guides:** - [Connect ChatGPT to MoltFlow](https://molt.waiflow.app/guides/connect-chatgpt-to-moltflow) — Custom GPT Actions, 10 min setup - [Connect Claude to MoltFlow](https://molt.waiflow.app/guides/connect-claude-to-moltflow) — MCP Server setup, 5 min - [Connect OpenClaw to MoltFlow](https://molt.waiflow.app/guides/connect-openclaw-to-moltflow) — Native AI config, 5 min setup
**How-To Guides:** - [Getting Started](https://molt.waiflow.app/blog/whatsapp-automation-getting-started) - [API Complete Guide](https://molt.waiflow.app/blog/moltflow-api-complete-guide) - [n8n Integration](https://molt.waiflow.app/blog/moltflow-n8n-whatsapp-automation) - [n8n + Google Sheets](https://molt.waiflow.app/blog/n8n-whatsapp-google-sheets) - [n8n Group Auto-Reply](https://molt.waiflow.app/blog/n8n-whatsapp-group-auto-reply) - [n8n Lead Pipeline](https://molt.waiflow.app/blog/n8n-whatsapp-lead-pipeline) - [n8n Multi-Model AI](https://molt.waiflow.app/blog/n8n-multi-model-ai-orchestration) - [AI Auto-Replies Setup](https://molt.waiflow.app/blog/ai-auto-replies-whatsapp-setup) - [Group Lead Generation](https://molt.waiflow.app/blog/whatsapp-group-lead-generation-guide) - [Customer Support](https://molt.waiflow.app/blog/openclaw-whatsapp-customer-support) - [RAG Knowledge Base](https://molt.waiflow.app/blog/rag-knowledge-base-deep-dive) - [Style Matching](https://molt.waiflow.app/blog/ai-auto-replies-whatsapp-setup#style-profiles) - [Lead Scoring](https://molt.waiflow.app/blog/whatsapp-lead-scoring-automation) - [Feedback Collection](https://molt.waiflow.app/blog/whatsapp-customer-feedback-collection) - [A2A Protocol](https://molt.waiflow.app/blog/a2a-protocol-agent-communication) - [Scaling ROI](https://molt.waiflow.app/blog/scaling-whatsapp-automation-roi)
[All guides →](https://molt.waiflow.app/guides)
---
## Platform Features
| Feature | Details | |---|---| | Messaging | Text, media, polls, vCards | | Bulk Send | Ban-safe, SSE progress | | Scheduled | Cron, timezone-aware | | Reports | 10 templates, cron, WhatsApp delivery | | Analytics | Campaign funnel, contact scores, send time optimization | | Groups | Custom lists, CSV export | | Leads/CRM | Detect signals, pipeline | | Monitoring | 50+ groups, keywords | | Labels | Sync to WA Business | | AI Replies | GPT-4/Claude, RAG | | Style Clone | Matches your writing tone | | RAG | PDF/TXT, semantic search | | Voice | Whisper transcription | | Reviews | Sentiment, auto-approve | | Anti-Spam | Rate limits, typing sim | | Safeguards | Block PII, injections | | Webhooks | HMAC signed, 10+ events | | A2A | E2E encrypted, JSON-RPC | | GDPR | Auto-expiry, compliance | | Delivery | Real-time SSE tracking, read/reply/ignored status |
---
## How MoltFlow Compares
| | Molt | Alt 1 | Alt 2 | Alt 3 | |---|:---:|:---:|:---:|:---:| | Messaging | 18 | 14 | 3 | 1 | | Groups | 8 | 4 | 0 | 0 | | Outreach | 7 | 0 | 0 | 0 | | CRM | 7 | 0 | 0 | 0 | | AI | 7 | 0 | 0 | 0 | | Reviews | 8 | 0 | 0 | 0 | | Security | 10 | 0 | 0 | 0 | | Platform | 8 | 0 | 0 | 0 | | **Total** | **90+** | **~15** | **~3** | **~1** |
---
## What This Skill Reads, Writes & Never Does
**Documentation and API reference.** Nothing is auto-installed or auto-executed. No scripts or executables are bundled in this package. All actions require user confirmation.
| Category | What happens | Requires opt-in? | |---|---|---| | API calls | HTTPS to `apiv2.waiflow.app` only | No (uses your scoped API key) | | Contact metadata | Contact names, timestamps, counts | No | | CRM pipeline | Lead status, engagement scores | No | | AI features | Statistical patterns via API | Yes (AI consent toggle) | | Local file | `.moltflow.json` — counts only, no PII | No | | API key | Local env var, never logged or shared | No |
**This skill never:** - Installs packages or runs code automatically - Sends messages without explicit user confirmation - Sends to non-whitelisted numbers (if configured) - Bypasses anti-spam or content safeguards - Shares data with third parties - Stores credentials in files (env vars only)
---
## Setup
> **Free tier available** — 1 session, > 50 messages/month, no credit card required.
**Env vars:** - `MOLTFLOW_API_KEY` (required) — create a minimum-scoped key from [your dashboard](https://molt.waiflow.app). Use the narrowest scope preset that covers your workflow. Rotate keys regularly. - `MOLTFLOW_API_URL` (optional) — defaults to `https://apiv2.waiflow.app`
**Authentication:** `X-API-Key: $MOLTFLOW_API_KEY` header or `Authorization: Bearer $TOKEN` (JWT).
**Base URL:** `https://apiv2.waiflow.app/api/v2`
---
## Security
- **Minimum-scoped API keys enforced** — `scopes` is a required field when creating keys. Always create the narrowest key possible (e.g., `messages:send` only). Use presets like "Messaging" or "Read Only" for common workflows. Never use full-scope keys with AI agents — create a dedicated, limited key. - **Use environment variables for keys** — set `MOLTFLOW_API_KEY` as an env var, not in shared config files. Rotate keys regularly. - **Phone whitelisting** — configure `allowed_numbers` in tenant settings to restrict which numbers can send outbound messages. Only whitelisted numbers are permitted. - **Anti-spam safeguards** — all outbound messages pass through reciprocity checks (contact must message you first), burst rate limiting, typing simulation, and random delays. Cannot be bypassed. - **Content safeguards** — outbound messages are scanned for PII, secrets, and prompt injection attempts. Blocked automatically before sending. - **Approval mode** — enable `require_approval` in tenant settings to hold all AI-generated messages for manual review before delivery. - **Webhook URL validation** — the API blocks private IPs, cloud metadata, and non-HTTPS schemes. Only configure endpoints you control. Always set a `secret` for HMAC verification - **Verify third-party packages before running** — if you follow the external setup guides to install MCP or GPT integrations, review the package source and maintainers first. This skill does not install or execute any packages. - **Review scripts locally before running** — the Python example scripts are hosted on GitHub, not bundled. Download, inspect the source, then run. - **Avoid high-privilege keys in shared environments** — for admin operations (key rotation, data export), use the browser dashboard or a short-lived scoped key. Never expose owner-level keys in shared shells. - **Test in a sandbox tenant first** — create a short-lived, scoped key for testing. Revoke after testing. Never share keys across tenants.
---
## AI Agent Integrations
25 MCP tools for Claude Desktop, Claude.ai, Claude Code, and OpenAI Custom GPTs.
**User Action Required** — each integration requires manual setup by the user. No code is installed automatically by this skill.
See [integrations.md](integrations.md) for setup guides and security notes.
---
## Modules
Each module has its own SKILL.md with endpoints and curl examples.
- **moltflow** (Core) — sessions, messaging, groups, labels, webhooks - **moltflow-outreach** — bulk send, scheduled messages, scheduled reports, custom groups - **moltflow-ai** — style cloning, RAG, voice transcription, AI replies - **moltflow-leads** — lead detection, CRM pipeline, bulk ops, export - **moltflow-a2a** — agent-to-agent protocol, encrypted messaging - **moltflow-reviews** — review collection, sentiment analysis, testimonial export - **moltflow-admin** — auth, API keys, billing, usage tracking - **moltflow-onboarding** — read-only account health check, growth opportunity reports
---
## Notes
- Anti-spam on all messages (typing, random delays) - Sessions require QR code pairing on first connect - Use E.164 phone format without `+` - AI features and A2A require Pro plan or above - Rate limits: Free 10, Starter 20, Pro 40, Biz 60/min
---
## Changelog
**v2.11.3** (2026-02-15) -- See [CHANGELOG.md](CHANGELOG.md) for full history.
<!-- FILEMAP:BEGIN --> ```text [moltflow file map]|root: . |.:{SKILL.md,CHANGELOG.md,integrations.md,package.json} |moltflow:{SKILL.md} |moltflow-ai:{SKILL.md} |moltflow-a2a:{SKILL.md} |moltflow-reviews:{SKILL.md} |moltflow-outreach:{SKILL.md} |moltflow-leads:{SKILL.md} |moltflow-admin:{SKILL.md} |moltflow-onboarding:{SKILL.md} ``` <!-- FILEMAP:END -->