Moltflow AI

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

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.

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.

Upload Document

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

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.

Build Style Profile

POST /ai/style/train

{
  "session_id": "session-uuid-...",
  "wa_chat_id": "5511999999999@c.us",
  "name": "Sales"
}

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.

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

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

Error Responses

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