Moltflow Onboarding

• "Help me get started" or "set up my account"
• "Find leads in my chats" or "find opportunities"
• "What should I do to grow?" or "suggest growth plays"
• "Optimize my setup" or "what am I missing?"
• "Run my daily briefing" or "give me my morning report"

Prerequisites

1. MOLTFLOW_API_KEY -- Generate from the MoltFlow Dashboard under Sessions > API Keys
2. Base URL: https://apiv2.waiflow.app/api/v2

Required API Key Scopes

Authentication

X-API-Key: <your_api_key>

Step 1: Fetch Account Data (Read-Only)

Gather data from these read-only endpoints. All are GET requests authenticated via X-API-Key: $MOLTFLOW_API_KEY header. Base URL: https://apiv2.waiflow.app/api/v2.

Step 2: Present Account Health Report

Format the fetched data as a status dashboard:

## MoltFlow Account Health

**Plan:** {plan} | **Tenant:** {tenant} | **Messages:** {used}/{limit} this month

| Area                  | Status | Details |
|-----------------------|--------|---------|
| WhatsApp Sessions     | ✅/❌  | {count} sessions, {working} active |
| Group Monitoring      | ✅/❌  | {monitored}/{available} groups |
| Custom Groups         | ✅/❌  | {count} groups ({member_count} contacts) |
| Lead Pipeline         | ✅/❌  | {lead_count} leads ({new_count} new, {contacted} contacted) |
| AI Features           | ✅/❌  | Consent {yes/no}, {profile_count} style profiles |
| Scheduled Messages    | ✅/❌  | {count} active |
| Review Collectors     | ✅/❌  | {count} active |
| Webhooks              | ✅/❌  | {count} configured |
| Conversations         | 📊     | {chat_count} conversations, {total_messages} messages |

Step 3: Analyze Growth Opportunities

Using the already-fetched data, identify and present these patterns:

3A: Chat Analysis

For each working session, analyze the chat list from Step 1:

• Unanswered contacts — people who messaged but got no reply (warm leads going cold)
• High-engagement contacts — most active by message count, not yet in a custom group
• Recent contacts — last 7 days, no follow-up sent
• Uncategorized contacts — not in any custom group

3B: Unmonitored Groups

Compare available groups (GET /groups/available/{session_id}) against monitored groups. Highlight large unmonitored groups by member count.

3C: Usage & Plan Utilization

From usage data, flag:

• Over 80% utilization — approaching plan limits
• Under 20% utilization — unused capacity

3D: Uncaptured Reviews

If no review collectors exist but there are active conversations, flag the gap.

Step 4: Suggest Next Actions

After presenting the read-only analysis, list concrete next steps the user can take. Each action references the appropriate skill module — see that module's SKILL.md for full endpoint documentation, request bodies, and examples.

All actions require explicit user approval. This skill only reads data and presents findings — it does not create, modify, or delete any resources.

Important Rules

• This skill is read-only — it fetches and analyzes data but never modifies account state
• All state-changing actions (creating groups, scheduling messages, etc.) must be performed via the referenced skill modules with explicit user approval
• If an API call fails, show the error and offer to retry or skip
• All API calls use the MOLTFLOW_API_KEY environment variable — never hardcode keys
• When analyzing chats, focus on business-relevant signals, not personal conversations
• Respect anti-spam: never suggest messaging contacts who haven't initiated contact