WhatsApp Business Suite — AI Leads, Channels, Campaigns & 32 MCP Tools

Original source / Raw SKILL.md

---
name: "WhatsApp Business Suite — AI Leads, Channels, Campaigns & 32 MCP Tools"
version: "2.16.4"
description: "Automate WhatsApp at scale — mine leads from groups with AI, broadcast to channel followers, bulk message with ban-safe delays, schedule campaigns, auto-reply in your voice, collect reviews, and track delivery. 90+ REST endpoints, 32 MCP tools for Claude & GPT, Python SDK. No Meta Business API required. Free tier available."
source: "MoltFlow Team"
risk: safe
homepage: "https://molt.waiflow.app"
requiredEnv:
  - MOLTFLOW_API_KEY
primaryEnv: MOLTFLOW_API_KEY
disable-model-invocation: true
metadata: {"openclaw":{"emoji":"📱","homepage":"https://molt.waiflow.app","requires":{"env":["MOLTFLOW_API_KEY"]},"primaryEnv":"MOLTFLOW_API_KEY"}}
---

# 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](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.

**"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": "[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
```

### 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](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 |
| 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](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

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


---

## Referenced Files

> The following files are referenced in this skill and included for context.

### integrations.md

```markdown
# AI Agent Integrations

> **User Action Required.** Each integration below
> requires manual setup outside this skill. This skill
> does not install packages or run code.

MoltFlow works as a tool provider for AI assistants.
Connect your preferred AI platform to the MoltFlow API
and manage WhatsApp directly from conversation.

## Claude Desktop (Native MCP)

25 MCP tools for sessions, messaging, groups, leads,
outreach, usage, and analytics. No npm package or
Node.js required -- connects directly to the MoltFlow
API via Streamable HTTP.

### Option A: OAuth (Recommended) -- No API Key Needed

Just add the URL. You'll be prompted to sign in the
first time you use a tool.

**Add to `claude_desktop_config.json`:**

```json
{
  "mcpServers": {
    "moltflow": {
      "url": "https://apiv2.waiflow.app/mcp"
    }
  }
}
```

On first use, Claude will prompt you to authorize.
Click through to sign in (or create a free account)
and approve access. That's it -- no API key to copy.

### Option B: API Key (Manual)

If you prefer explicit key management:

```json
{
  "mcpServers": {
    "moltflow": {
      "url": "https://apiv2.waiflow.app/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```

**Required scopes:** Use the minimum scopes for your
workflow: `sessions:read`, `messages:send`, `leads:read`,
`custom-groups:read`, `usage:read`. Create a scoped key
at Dashboard > Sessions > API Keys tab.

**Setup guide:** [Connect Claude to MoltFlow](https://molt.waiflow.app/guides/connect-claude-to-moltflow)

**Dashboard setup page:** [https://molt.waiflow.app/mcp](https://molt.waiflow.app/mcp)

## Claude.ai Web (Remote MCP)

No installation required -- configure in Claude.ai under
Settings > Integrations > MCP Servers:

- **URL:** `https://apiv2.waiflow.app/mcp`

OAuth handles authentication automatically. You'll be
prompted to sign in when you first use a MoltFlow tool.

Alternatively, use manual auth:
- **Auth header:** `X-API-Key`
- **Value:** Your scoped MoltFlow API key

All 25 tools are available immediately after configuration.

**Setup guide:** [Connect Claude to MoltFlow](https://molt.waiflow.app/guides/connect-claude-to-moltflow)

## Claude Code

Add MoltFlow as a remote MCP server:

```bash
claude mcp add moltflow --transport http --url https://apiv2.waiflow.app/mcp
```

OAuth handles authentication automatically. On first
tool use you'll be prompted to sign in via your browser.

For manual auth with an API key:

```bash
claude mcp add moltflow --transport http --url https://apiv2.waiflow.app/mcp --header "X-API-Key: YOUR_API_KEY_HERE"
```

All 25 tools are available after adding the server.

**Setup guide:** [Connect Claude to MoltFlow](https://molt.waiflow.app/guides/connect-claude-to-moltflow)

## ChatGPT (MCP Connector)

Add MoltFlow in ChatGPT settings under MCP Servers:

- **URL:** `https://apiv2.waiflow.app/mcp`

OAuth handles authentication. You'll sign in via your
browser on first use.

## OpenAI Custom GPTs

Import the MoltFlow OpenAPI specification in GPT Builder
to give your GPT access to messaging, sessions, leads,
and outreach endpoints.

**Setup guide:** [Connect ChatGPT to MoltFlow](https://molt.waiflow.app/guides/connect-chatgpt-to-moltflow)

Set Authentication to "API Key" with header `X-API-Key`
and paste your scoped MoltFlow API key.

---

## MCP Endpoint Details

- **URL:** `https://apiv2.waiflow.app/mcp`
- **Protocol:** MCP Streamable HTTP (2025-03-26)
- **Auth:** OAuth 2.1 (automatic) or `X-API-Key` header (manual)
- **OAuth discovery:** `https://apiv2.waiflow.app/.well-known/oauth-authorization-server`
- **Tools:** 25 tools across 7 categories (Sessions, Messaging, Groups, Leads, Outreach, Usage, Analytics)

---

## Security Notes

- **OAuth 2.1 with PKCE** -- the recommended auth method.
  Uses S256 code challenge, no client secrets exposed.
- **Scoped API keys** -- if using manual auth, create a
  key with minimum required scopes at Dashboard >
  Sessions > API Keys tab.
- **Environment variables** -- store API keys as env vars,
  not in shared config files. Rotate regularly.
- **GDPR compliance** -- all data processing follows
  GDPR guidelines with appropriate consent gates.

---

## A2A Discovery (ERC-8004)

MoltFlow is registered as [Agent #25477](https://8004agents.ai/ethereum/agent/25477) on Ethereum mainnet.

Other AI agents can discover MoltFlow through:

- **On-chain**: Query ERC-8004 Identity Registry at `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`
- **HTTP**: Fetch `https://apiv2.waiflow.app/.well-known/agent.json`
- **Agent card**: `https://molt.waiflow.app/.well-known/erc8004-agent.json`

```

### CHANGELOG.md

```markdown
# Changelog

All notable changes to the **MoltFlow Skills** package are documented here.

---

## [2.16.2] - 2026-03-02

### Added
- **Channel discover + import** — 2 new MCP tools: discover_channels, import_channel (8 channel tools total)
- **channels.py** — added `discover` and `import` CLI commands
- **erc8004-agent.json** — updated to 15 mcpTools (was 13)
- **Help page, llms.txt, llms-full.txt, blog post** — all surfaces updated with discover/import endpoints

---

## [2.16.0] - 2026-03-02

### Added
- **WhatsApp Channels (v7.0)** — 6 MCP tools: list_channels, get_channel, create_channel, delete_channel, broadcast_channel_post, schedule_channel_post
- **channels.py utility script** — CLI for channel management (broadcast, schedule, sync, capabilities check)
- **moltflow-outreach/SKILL.md** — Channel broadcasting section with endpoints, plan limits, and examples
- **GET /channels/capabilities** — WAHA version check endpoint for media broadcast compatibility

---

## [2.15.1] - 2026-02-22

### Fixed
- **OpenClaw "Suspicious" classification resolved** — `requiredEnv` now correctly declares `MOLTFLOW_API_KEY` (was empty `[]`, contradicting `primaryEnv`)
- Removed `optionalEnv` field — LLM API key is configured via the MoltFlow web dashboard, never passed through this skill
- Updated metadata JSON to match `requiredEnv` declaration
- Clarified description: documentation-only package, zero executables, MOLTFLOW_API_KEY is the only credential
- **MCP server endpoint fixes** — corrected 6 wrong API paths discovered during comprehensive testing:
  - `list_monitored_groups`: `groups/monitored` → `groups`
  - `add_monitored_group`: `groups/monitored` → `groups`
  - `get_current_usage`: `usage` → `usage/current`
  - `get_plan_limits`: `usage/limits` → `usage/current`
  - `list_chats`: session_id moved from query param to path param
  - `get_chat_messages`: corrected path and added missing session_id parameter
- Synced all sub-skill versions to 2.15.1

---

## [2.15.0] - 2026-02-20

### Added
- New MCP tool `moltflow_get_group_messages`: retrieve paginated messages from a monitored WhatsApp group, including AI analysis results (intent, lead_score, confidence, reason) when AI monitoring is enabled
- AI Group Intelligence support: messages returned by the tool include `ai_analysis` fields populated by the Phase 91 AI analysis pipeline
- Documentation updates in SKILL.md, moltflow-leads/SKILL.md, and moltflow/SKILL.md reflecting the new tool and AI analysis fields

---

## v2.14.6 (2026-02-19)

### Fixed
- **Republished both ClawHub slugs** — legacy `whatsapp-automation-a2a` was showing "Skill not found"
- **Restored correct display names** per v2.14.4 convention (no ERC-8004 in titles)

---

## v2.14.4 (2026-02-19)

### Changed
- **Updated both ClawHub display names** for better search discoverability
  - `whatsapp-automation-a2a` — "WhatsApp Automation — No Meta API | Bulk Send, Lead Mining, AI Outreach & Scheduled Campaigns"
  - `moltflow-whatsapp` — "WhatsApp AI Agent — No Meta API | Lead Mining, Smart Replies, Bulk Campaigns & Scheduled Reports"
- Dropped MoltFlow/ERC-8004 from titles — unfamiliar to most users
- Restored `whatsapp-automation-a2a` search visibility (was missing after v2.14.1)

---

## v2.14.1 (2026-02-19)

### Fixed
- **ClawHub "suspicious" classification resolved** — rewrote moltflow-onboarding from agent personality instructions to a read-only analysis tool
- Removed "BizDev Agent" framing from onboarding skill and main SKILL.md description
- Onboarding skill now explicitly read-only — all write endpoints moved to referenced skill modules
- Removed inline Phase 4 write endpoints and Phase 5 settings configuration from onboarding
- All safety guardrails preserved (disable-model-invocation, explicit user approval, scoped API keys)

---

## v2.14.0 (2026-02-18)

### Changed
- **Renamed skill** — "WhatsApp Ultimate — No Meta API | Lead Mining, Bulk Send, Scheduled Reminders & Follow-ups"
- Highlights the key differentiator: no Meta Business API required

---

## v2.13.0 (2026-02-18)

### Fixed
- **17 production bugs** fixed across API, MCP server, frontend, and workers
- WAHA HMAC signature verification now uses raw bytes (was re-serializing, never matched)
- Checkout 202 response no longer corrupts auth tokens
- A2A import crash on fresh Docker builds (missing source file)
- Bulk send distributed lock prevents duplicate message delivery
- MCP sanitizer boundary marker escape prevents prompt injection breakout
- Login rate limit atomic pipeline prevents permanent user lockout
- Admin suspend user now persists to DB (was hardcoded property)
- ORM decrypted fields no longer risk plaintext flush to encrypted columns
- Stripe webhook construct_event wrapped in asyncio.to_thread
- Timezone-aware datetime mismatches on timezone-naive columns

### Changed
- API version bumped to v2.0.0
- MCP server version bumped to v2.0.0
- OpenAI Actions version bumped to v2.0.0

---

## v2.12.3 (2026-02-17)

### Added
- **Business use case scenarios** across all sub-skills — real-world examples for healthcare, real estate, e-commerce, restaurants, agencies, and more
- **12 vertical-specific prompts** in main SKILL.md "Just Ask Claude" section replacing generic examples
- **GDPR + Analytics prompts** added to main skill showcase

### Fixed
- Replaced hardcoded scheduled message date with future date

---

## v2.12.0 (2026-02-17)

### Changed
- Cleaned up documentation wording for ClawHub review compliance
- Removed internal implementation details from public API docs
- Simplified data access descriptions across all sub-skills

## v2.11.4 (2026-02-16)

### Fixed
- Fixed ERC-8004 explorer URLs to include `/ethereum/` path segment across all files

## v2.11.3 (2026-02-15)

### Fixed
- Reverted Setup and Security sections to v2.10.2 wording for ClawHub review compatibility

## v2.11.0 (2026-02-15)

### Added
- **ERC-8004 Agent Registration** — MoltFlow registered as Agent #25477 on Ethereum mainnet
- ERC-8004 section in SKILL.md with registry details and discovery URLs
- New keywords: `erc8004`, `ethereum-agent`, `on-chain-agent`

---

## v2.10.1 (2026-02-14)

### Added
- **New code samples** — CRM pipeline updates, bulk group operations, CSV export, campaign controls
- **Delivery tracking** added to Platform Features table
- **Comparison table** total updated to 90+ endpoints

### Changed
- Removed scripts section (scripts will move to dedicated repo)

---

## v2.9.8 (2026-02-14)

### Changed
- **Integrations.md cleaned up** — simplified to setup guide links and security notes only
- **Changelog consolidated** — removed verbose patch-level entries

### Security
- **Documentation-only package** — zero executables, zero install scripts, zero local file writes
- **Scoped API keys enforced** — all examples use minimum required scopes; wildcard keys never recommended
- **Conversation context gated** — API returns HTTP 403 until tenant explicitly opts in at Settings > Account > Data Access
- **High-privilege endpoints removed from skill docs** — only consumer-facing API endpoints documented; administrative operations available on website only
- **Model invocation disabled** — `disable-model-invocation: true` prevents autonomous agent actions; all operations require explicit user invocation
- **Anti-spam safeguards documented** — reciprocity checks, burst rate limits, and content safeguards apply to all outbound messages

---

## v2.9.7 (2026-02-14)

### Changed
- **Code samples reordered** — campaign analytics, real-time delivery tracking (SSE), and engagement leaderboard moved to top of main SKILL.md
- **Admin skill streamlined** — focused on auth, API keys, billing, usage, and tenant settings
- **Restored integrations.md** — clean version with setup guide links and security notes

---

## v2.9.0 (2026-02-14)

### Added
- Campaign analytics endpoints documentation (Pro+ plans)
- Contact engagement scoring and leaderboard
- Send time optimization heatmap
- 3 new MCP tools for analytics

### Changed
- Display name updated for search discoverability
- Documentation refined for security best practices
- All marketing language clarified for accuracy
- Package reduced to documentation-only (zero executables)

---

## v2.8.6 (2026-02-14)

### Changed
- **Least-privilege API keys** — `scopes` is now required when creating API keys; presets available (Messaging, Outreach, Read Only)
- **403 errors include required scopes** — `X-Required-Scopes` header tells callers exactly which scopes they need

---

## v2.8.0 (2026-02-13)

### Added
- **Scheduled Reports** — 10 report templates with WhatsApp delivery support
- Reports API (8 endpoints): templates, create, list, get, update, pause, resume, delete
- `reports:read` and `reports:manage` scopes

### Changed
- Platform features table updated with reports
- Outreach module now includes scheduled reports

---

## v2.7.0 (2026-02-13)

### Changed
- Documentation restructured for clarity — "What This Skill Reads, Writes & Never Does" section
- Privacy documentation expanded with opt-in requirements and explicit "never does" list
- Security section expanded — anti-spam safeguards, content safeguards, approval mode

---

## v2.4.0 (2026-02-13)

### Added
- **AI Agent Integrations** — setup guides for Claude Desktop, Claude.ai Web, Claude Code, and ChatGPT
- Remote MCP gateway documentation (`apiv2.waiflow.app/mcp`)

---

## v2.0.0 (2026-02-12)

### Highlights

- **Scheduled Messages** — One-time, daily/weekly/monthly, or custom cron. Timezone-aware. Pause, resume, cancel. Full execution history.
- **Bulk Messaging** — Broadcast to custom groups with ban-safe throttling. Real-time SSE progress. Pause/resume/cancel mid-flight.
- **Custom Groups** — Build targeted contact lists from WhatsApp conversations. Import members, export CSV/JSON.
- **Lead Management** — Leads with full pipeline tracking. Bulk operations, CSV/JSON export.
- **Knowledge Base (RAG)** — Upload PDF/TXT, semantic search with embeddings. AI uses your docs for accurate answers.
- **Voice Transcription** — Whisper-powered voice message transcription with async task queue.
- **90+ API Endpoints** — Complete platform coverage across 6 modules.

### Added

- Scheduled Messages API (9 endpoints)
- Bulk Send API (7 endpoints)
- Custom Groups API (10 endpoints)
- Leads API (8 endpoints)
- Knowledge Base / RAG API (4 endpoints)
- Voice Transcription API (3 endpoints)
- Sub-skills: moltflow-outreach, moltflow-leads, moltflow-admin

---

## v1.6.0 (2026-02-11)

### Highlights

- **Anti-Spam Protection** — Reciprocity checks, burst rate limiting, and health monitoring on all outbound messages.
- **Yearly Billing** — Lock in yearly pricing at $239.90/year.
- **4 Focused Sub-Skills** — Core, AI, A2A, and Reviews modules.

---

## v1.0.0 (2026-02-06)

### Highlights

- **All-in-One WhatsApp API** — Sessions, messaging, groups, labels, webhooks, AI replies, reviews, and A2A unified under a single skill.
- **Agent-to-Agent Protocol** — JSON-RPC 2.0 with end-to-end encryption.
- **AI That Learns Your Voice** — Build style profiles from conversation context. Auto-replies sound like you.
- Full API reference with curl examples across 6 modules.

---

*Built with care by the [MoltFlow](https://waiflow.app) team.*

```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "alex-tradequo",
  "slug": "whatsapp-automation-suite",
  "displayName": "WhatsApp Automation Suite — AI Leads, Bulk Campaigns & 32 MCP Tools",
  "latest": {
    "version": "1.0.0",
    "publishedAt": 1772522824260,
    "commit": "https://github.com/openclaw/skills/commit/e837f9f9c8f66572b2bb098d1cdfa521d091d9c5"
  },
  "history": []
}

```