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. 97+ endpoints. 32 MCP tools. 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.

"Post our weekly product update to all 5,000 WhatsApp Channel followers every Monday"

Schedule a recurring channel post with cron expression, tracks each post as a ChannelPost record with status.

"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": "120363012345@g.us",
    "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": "5511999999999@c.us",
    "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": "123@c.us",
    "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": "1234567890@c.us",
    "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

Broadcast to a WhatsApp Channel

bash
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "New product just dropped. Tap the link for early access."}' \
  https://apiv2.waiflow.app/api/v2/channels/{channel_id}/broadcast

Schedule a recurring channel post

bash
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Monday Newsletter",
    "session_id": "uuid",
    "channel_id": "uuid",
    "target_type": "channel",
    "message_content": "This week: ...",
    "schedule_type": "recurring",
    "cron_expression": "0 9 * * 1"
  }' \
  https://apiv2.waiflow.app/api/v2/scheduled-messages

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

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

| 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 | | Channels | Text/image/video broadcasting, scheduled posts, follower sync | | AI Group Intel | Intent classification, lead scoring (Pro+) | | 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 | | Channels | 7 | 0 | 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 | 97+ | ~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. 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

32 MCP tools for Claude Desktop, Claude.ai, Claude Code, and OpenAI Custom GPTs. Includes moltflow_get_group_messages for AI-powered group intelligence and 6 channel tools for broadcasting, scheduling, and follower management.

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, channel broadcasting

• 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.16.0 (2026-03-02) -- See CHANGELOG.md for full history.

<!-- FILEMAP:BEGIN -->

text
[moltflow file map]|root: .
|.:{SKILL.md,CHANGELOG.md,integrations.md}
|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 -->