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 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

Free tier available. Sign up

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.

"Analyze the last 50 messages in my real estate group and score every lead"

AI Group Intelligence classifies message intent (buying_intent, inquiry, complaint), scores leads 1-10, and surfaces high-priority contacts. Requires Pro plan + your LLM API key.

"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

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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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)

Guides & Tutorials

AI Integration Guides: - Connect ChatGPT to MoltFlow — Custom GPT Actions, 10 min setup - Connect Claude to MoltFlow — MCP Server setup, 5 min - Connect OpenClaw to MoltFlow — Native AI config, 5 min setup

How-To Guides: - Getting Started - API Complete Guide - n8n Integration - n8n + Google Sheets - n8n Group Auto-Reply - n8n Lead Pipeline - n8n Multi-Model AI - AI Auto-Replies Setup - Group Lead Generation - Customer Support - RAG Knowledge Base - Style Matching - Lead Scoring - Feedback Collection - A2A Protocol - Scaling ROI

All guides →

Platform Features

How MoltFlow Compares

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.

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. 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

26 MCP tools for Claude Desktop, Claude.ai, Claude Code, and OpenAI Custom GPTs. Includes moltflow_get_group_messages for AI-powered group intelligence (retrieve messages with intent classification, lead scoring, and confidence scores).

User Action Required — each integration requires manual setup by the user. No code is installed automatically by this skill.

See 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.15.0 (2026-02-20) -- See CHANGELOG.md for full history.

[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}