Moltflow

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

Manage WhatsApp sessions, send messages, monitor groups, organize with labels, and receive real-time events via webhooks.

Real-World Scenarios

Dental clinic — "Send an appointment confirmation to each patient after they book, and a reminder 24 hours before their visit."

Property manager — "Monitor my tenant WhatsApp groups for maintenance keywords like 'leak', 'broken', and 'urgent', and flag them instantly."

E-commerce store — "When a customer messages my support number, auto-label them as 'New Inquiry' and route the chat to the right team."

Logistics company — "Set up a webhook so my dispatch system gets notified the moment a driver sends a delivery confirmation photo."

When to Use

• "Connect WhatsApp" or "create a session"
• "Send a WhatsApp message" or "send text to contact"
• "Monitor a WhatsApp group" or "list groups"
• "Label contacts" or "sync labels from WhatsApp"
• "Set up a webhook" or "listen for WhatsApp events"
• "Get QR code" or "start session"
• "List chats" or "get conversations"

Prerequisites

1. MOLTFLOW_API_KEY -- Generate from the MoltFlow Dashboard under Settings > API Keys
2. All requests require authentication via Authorization: Bearer <token> or X-API-Key: <key>
3. Base URL: https://apiv2.waiflow.app/api/v2

Required API Key Scopes

Authentication

Every request must include one of:

Authorization: Bearer <jwt_token>

or

X-API-Key: <your_api_key>

Sessions

Manage WhatsApp connections. Each session represents one WhatsApp account linked via QR code.

Session Status Values

Sessions progress through these states: stopped -> starting -> qr_code -> working -> failed

Create Session

POST /sessions

{
  "name": "My WhatsApp"
}

Response 201 Created:

{
  "id": "a1b2c3d4-...",
  "name": "My WhatsApp",
  "status": "stopped",
  "phone_number": null,
  "is_business": false,
  "created_at": "2026-02-11T10:00:00Z"
}

Start Session and Get QR

After creating a session, start it and retrieve the QR code:

1. POST /sessions/{id}/start -- begins the WAHA engine
2. Wait for status to become qr_code (use SSE events or poll)
3. GET /sessions/{id}/qr -- returns the QR code image

SSE Events

GET /sessions/{id}/events?token=<jwt> returns a Server-Sent Events stream. Events include session status changes, incoming messages, and connection updates.

Session Settings

PATCH /sessions/{id}/settings

Configure per-session behavior. Settings are stored in the session's config JSON field.

// Request
{
  "auto_transcribe": true
}

// Response
{
  "status": "ok",
  "config": {
    "auto_transcribe": true
  }
}

Messages

Send and retrieve WhatsApp messages through connected sessions.

Send Text Message

POST /messages/send

{
  "session_id": "a1b2c3d4-...",
  "chat_id": "5511999999999@c.us",
  "message": "Hello from MoltFlow!"
}

Response 201 Created:

{
  "id": "msg-uuid-...",
  "chat_id": "chat-uuid-...",
  "wa_message_id": "ABCD1234",
  "direction": "outbound",
  "message_type": "text",
  "content_preview": "Hello from MoltFlow!",
  "status": "sent",
  "sent_at": "2026-02-11T10:05:00Z",
  "created_at": "2026-02-11T10:05:00Z"
}

Chat ID Format

• Individual contacts: <phone>@c.us (e.g., 5511999999999@c.us)
• Groups: <group_id>@g.us (e.g., 120363012345678901@g.us)

Send Poll

POST /messages/send/poll

{
  "session_id": "a1b2c3d4-...",
  "chat_id": "5511999999999@c.us",
  "title": "Preferred meeting time?",
  "options": ["Morning", "Afternoon", "Evening"],
  "allow_multiple": false
}

Groups

Monitor WhatsApp groups for keywords, messages, and activity.

Add Group to Monitoring

POST /groups

{
  "session_id": "a1b2c3d4-...",
  "wa_group_id": "120363012345678901@g.us",
  "monitor_mode": "keywords",
  "monitor_keywords": ["urgent", "support", "help"]
}

Monitor Modes

• all -- Capture every message in the group
• keywords -- Only capture messages matching specified keywords
• mentions -- Only when your account is mentioned
• first_message -- Only first messages from new users (default for new groups)
• ai_analysis -- AI-powered intent classification and lead scoring (Pro+ only)

Group Messages (AI Intelligence)

GET /groups/{group_id}/messages

Retrieve paginated messages from a monitored group, including AI analysis results.

Query parameters: limit (default 50, max 100), offset (default 0)

Requires scope: groups:read

{
  "items": [
    {
      "id": "msg-uuid",
      "sender_phone": "+15550123456",
      "sender_name": "John D.",
      "content_preview": "I'm interested in the 3BR property",
      "wa_timestamp": "2026-02-20T14:30:00Z",
      "ai_analysis": {
        "intent": "buying_intent",
        "lead_score": 9,
        "confidence": 0.92,
        "reason": "Explicit interest in a specific property with buying signal"
      }
    }
  ],
  "total": 142,
  "limit": 50,
  "offset": 0,
  "has_more": true
}

ai_analysis is null when AI hasn't processed the message or AI monitoring is not enabled.