Skip to main content
Generaldvcrn

moltflow-ai

AI-powered WhatsApp features: auto-replies, voice transcription, RAG knowledge base, and style profiles. Use when: ai reply, transcribe voice, knowledge base, upload document, build style, learn mode.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--moltflow-ai
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/alex-tradequo--moltflow-whatsapp/skills/whatsapp-business-suite-ai-leads-channels-campaigns-32-mcp-tools/moltflow-ai/SKILL.md -o .claude/skills/moltflow-ai.md

Drops the SKILL.md into .claude/skills/moltflow-ai.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

MoltFlow -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale. 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

MoltFlow AI Features

AI-powered capabilities for WhatsApp automation: voice transcription, RAG knowledge base, style profile learning, and intelligent reply generation.

Real-World Scenarios

Healthcare clinic — "Transcribe patient voice notes sent via WhatsApp and save them as searchable text records I can pull up later."

Law firm — "Upload our service agreements to the knowledge base so the AI can answer client questions about terms and pricing accurately."

Sales team — "Clone my top closer's writing style so AI replies to leads sound like him — casual, confident, uses emojis."

Customer support — "Auto-reply to common questions like 'What are your hours?' and 'Where are you located?' using our FAQ document."

When to Use

  • "Transcribe a voice message" or "convert audio to text"
  • "Upload a document to knowledge base" or "ingest PDF"
  • "Search knowledge base" or "find in documents"
  • "Build style profile" or "learn my writing style"
  • "Generate an AI reply" or "auto-reply to customer"
  • "Preview AI response" or "test reply generation"
  • "List knowledge sources" or "delete document"

Prerequisites

  1. MOLTFLOW_API_KEY -- Generate from the MoltFlow Dashboard under Settings > API Keys
  2. Pro plan or higher ($29.90/mo) -- AI features are not available on the Starter plan
  3. Base URL: https://apiv2.waiflow.app/api/v2
  4. All AI endpoints are under the /ai prefix

Required API Key Scopes

Scope Access
ai read/manage

Authentication

Every request must include one of:

Authorization: Bearer <jwt_token>

or

X-API-Key: <your_api_key>

Voice Transcription

Transcribe WhatsApp voice messages using Whisper AI. Transcription runs asynchronously via a Celery worker.

Method Endpoint Description
POST /ai/voice/transcribe Queue a voice message for transcription
GET /ai/voice/status/{task_id} Check transcription task status
GET /ai/messages/{message_id}/transcript Get the transcript for a message

Queue Transcription

POST /ai/voice/transcribe

{
  "message_id": "msg-uuid-..."
}

Response 200 OK:

{
  "task_id": "celery-task-id-...",
  "message_id": "msg-uuid-...",
  "status": "queued"
}

Check Status

GET /ai/voice/status/{task_id}

{
  "task_id": "celery-task-id-...",
  "status": "completed",
  "result": {
    "transcript": "Hello, I wanted to ask about...",
    "language": "en",
    "confidence": 0.95
  }
}

Status values: queued, processing, completed, failed

Get Transcript

GET /ai/messages/{message_id}/transcript

{
  "message_id": "msg-uuid-...",
  "transcript": "Hello, I wanted to ask about...",
  "language": "en",
  "confidence": 0.95,
  "transcribed_at": "2026-02-11T10:05:00Z"
}

RAG Knowledge Base

Build a searchable knowledge base for AI-powered replies grounded in your business data.

Method Endpoint Description
POST /ai/knowledge/ingest Upload and index a document
POST /ai/knowledge/search Semantic search across documents
GET /ai/knowledge/sources List all indexed documents
DELETE /ai/knowledge/{source_id} Delete a document

Upload Document

POST /ai/knowledge/ingest (multipart/form-data)

Field Type Description
file File PDF or TXT file (max 100MB)

Response 200 OK:

{
  "id": "src-uuid-...",
  "name": "product-catalog.pdf",
  "source_type": "application/pdf",
  "chunk_count": 47,
  "status": "indexed",
  "task_id": "celery-task-id-..."
}

Supported file types: application/pdf, text/plain (.pdf, .txt)

Search Knowledge Base

POST /ai/knowledge/search

{
  "query": "What is the return policy?",
  "top_k": 5
}

Response 200 OK:

{
  "query": "What is the return policy?",
  "results": [
    {
      "source_id": "src-uuid-...",
      "content_type": "application/pdf",
      "content_preview": "Our return policy allows returns within 30 days...",
      "metadata": {"page": 12, "chunk": 3},
      "similarity": 0.92
    }
  ],
  "count": 1
}

Optional filters:

{
  "query": "shipping costs",
  "filters": {"source_type": "application/pdf"},
  "top_k": 10
}

List Documents

GET /ai/knowledge/sources

[
  {
    "id": "src-uuid-...",
    "name": "product-catalog.pdf",
    "source_type": "application/pdf",
    "chunk_count": 47,
    "status": "indexed",
    "created_at": "2026-02-11T09:00:00Z",
    "indexed_at": "2026-02-11T09:02:00Z"
  }
]

Document status values: processing, indexed, failed

Delete Document

DELETE /ai/knowledge/{source_id} -- Returns 204 No Content

Style Profiles (Learn Mode)

Configure AI writing style profiles scoped to individual chats or as a general profile. The AI auto-selects the best matching profile when generating replies.

Method Endpoint Description
POST /ai/style/train Start building a style profile
GET /ai/style/status/{task_id} Check build status
GET /ai/style/profile Get a style profile
GET /ai/style/profiles List all style profiles
DELETE /ai/style/profile/{profile_id} Delete a style profile

Build Style Profile

POST /ai/style/train

{
  "session_id": "session-uuid-...",
  "wa_chat_id": "5511999999999@c.us",
  "name": "Sales"
}
Field Type Required Description
contact_id string No Legacy — use wa_chat_id instead
session_id UUID No Session to scope the build to
wa_chat_id string No Chat to scope the build to (WhatsApp JID). Omit for general profile
name string No Profile name (e.g., "Sales", "Support", "Family")

Note: Omit both session_id and wa_chat_id to build a general profile from all conversations.

Response 200 OK:

{
  "task_id": "celery-task-id-...",
  "tenant_id": "tenant-uuid-...",
  "contact_id": "5511999999999@c.us",
  "status": "queued"
}

The build runs asynchronously. Check progress with the status endpoint.

Get Style Profile

GET /ai/style/profile?contact_id=5511999999999@c.us

{
  "id": "profile-uuid-...",
  "tenant_id": "tenant-uuid-...",
  "contact_id": "5511999999999@c.us",
  "name": "Sales",
  "session_id": "session-uuid-...",
  "wa_chat_id": "5511999999999@c.us",
  "features": {
    "avg_sentence_length": 12.5,
    "formality_score": 0.7,
    "emoji_frequency": 0.15,
    "vocabulary_richness": 0.82
  },
  "sample_count": 150,
  "last_trained_at": "2026-02-11T09:30:00Z"
}

List All Profiles

GET /ai/style/profiles

[
  {
    "id": "profile-uuid-1",
    "tenant_id": "tenant-uuid-...",
    "name": "Sales",
    "session_id": "session-uuid-...",
    "wa_chat_id": "5511999999999@c.us",
    "features": { "formality_score": 0.7 },
    "sample_count": 150,
    "last_trained_at": "2026-02-11T09:30:00Z"
  },
  {
    "id": "profile-uuid-2",
    "tenant_id": "tenant-uuid-...",
    "name": "General",
    "session_id": null,
    "wa_chat_id": null,
    "features": { "formality_score": 0.5 },
    "sample_count": 420,
    "last_trained_at": "2026-02-11T10:00:00Z"
  }
]

Delete Profile

DELETE /ai/style/profile/{profile_id} -- Returns 204 No Content

AI Reply Generation

Generate intelligent reply suggestions using RAG context and style profiles.

Method Endpoint Description
POST /ai/generate-reply Generate a reply suggestion
GET /ai/preview Preview a reply without tracking usage

Generate Reply

POST /ai/generate-reply

{
  "contact_id": "5511999999999@c.us",
  "context": "Customer asks: Do you offer international shipping?",
  "use_rag": true,
  "apply_style": true,
  "profile_id": "profile-uuid-...",
  "session_id": "session-uuid-..."
}

Response 200 OK:

{
  "reply": "Yes, we ship internationally to over 50 countries! Shipping typically takes 7-14 business days. You can find our full shipping policy on our website.",
  "rag_sources": ["product-catalog.pdf"],
  "style_applied": true,
  "model": "gpt-4o-mini",
  "tokens_used": 245,
  "requires_approval": false
}

Parameters

Field Type Default Description
contact_id string required WhatsApp JID of the contact
context string required Customer question or prompt for reply generation (max 2000 chars)
use_rag boolean true Include knowledge base context in generation
apply_style boolean true Apply style profile to response
profile_id UUID null Specific style profile to use (skips auto-selection cascade)
session_id UUID null Session for cascade profile resolution
approved boolean false Set true to confirm an approval-required reply

Note: If profile_id is omitted and apply_style is true, the API auto-selects the best profile using the cascade: exact chat match → session-level → tenant-level general → no style.

Preview Reply

GET /ai/preview?contact_id=5511999999999@c.us&context=What+are+your+hours&use_rag=true&apply_style=true

Same response format as generate-reply, but does not count toward usage metrics.

Safety Features

AI reply generation includes built-in safety:

  • Input sanitization -- Detects and blocks prompt injection attempts
  • Intent verification -- Flags ambiguous or high-risk intents for confirmation
  • Output filtering -- Screens generated content for PII, secrets, and policy violations
  • Content policy -- Tenant-configurable rules (see moltflow-a2a skill)

Examples

Upload a knowledge base document

curl -X POST https://apiv2.waiflow.app/api/v2/ai/knowledge/ingest \
  -H "X-API-Key: $MOLTFLOW_API_KEY" \
  -F "file=@product-catalog.pdf"

Generate an AI reply using RAG

curl -X POST https://apiv2.waiflow.app/api/v2/ai/generate-reply \
  -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
  }'

Generate reply with specific profile

curl -X POST https://apiv2.waiflow.app/api/v2/ai/generate-reply \
  -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,
    "profile_id": "profile-uuid-..."
  }'

Build a style profile

curl -X POST https://apiv2.waiflow.app/api/v2/ai/style/train \
  -H "X-API-Key: $MOLTFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "session-uuid-...",
    "wa_chat_id": "5511999999999@c.us",
    "name": "Sales"
  }'

Plan Requirements

Feature Starter Pro ($29.90/mo) Business ($69.90/mo)
Voice Transcription -- Yes Yes
RAG Knowledge Base -- Yes (10 docs) Yes (unlimited)
Style Profiles -- Yes (3 profiles) Yes (unlimited)
AI Reply Generation -- Yes Yes

Error Responses

Status Meaning
400 Bad request (invalid input, unsupported file type)
401 Unauthorized (missing or invalid auth)
403 Forbidden (feature requires Pro plan or higher)
404 Resource not found (message, document, profile)
413 File too large (exceeds 100MB limit)
429 Rate limited

Related Skills

  • moltflow -- Core API: sessions, messaging, groups, labels, webhooks
  • moltflow-outreach -- Bulk Send, Scheduled Messages, Custom Groups
  • moltflow-leads -- Lead detection, pipeline tracking, bulk operations, CSV/JSON export
  • moltflow-a2a -- Agent-to-Agent protocol, encrypted messaging, content policy
  • moltflow-reviews -- Review collection and testimonial management
  • moltflow-admin -- Platform administration, user management, plan configuration