v2.15.1

WhatsApp Automation — No Meta API | Bulk Send, Lead Mining, AI Outreach & Scheduled Campaigns

Waiflow Waiflow ← All skills

Documentation-only WhatsApp API reference — zero executables, zero install scripts, zero local file writes. All actions require explicit user invocation. Pro...

Downloads
1.1k
Stars
2
Versions
59
Updated
2026-02-24

Install

npx clawhub@latest install whatsapp-automation-a2a

Documentation

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.

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

(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

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.

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

| 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 enforcedscopes 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](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](CHANGELOG.md) for full history.

<!-- FILEMAP:BEGIN -->

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

Launch an agent with WhatsApp Automation — No Meta API | Bulk Send, Lead Mining, AI Outreach & Scheduled Campaigns on Termo.