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

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

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

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

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

Broadcast to a WhatsApp Channel

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

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

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

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.

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