@moltflow/skills 1.4.0 → 2.0.0

package/scripts/outreach.py

@@ -0,0 +1,228 @@
+#!/usr/bin/env python3
+"""
+MoltFlow Outreach - Bulk Send, Scheduled Messages, Custom Groups
+"""
+import os
+import json
+import requests
+
+API_KEY = os.environ.get("MOLTFLOW_API_KEY")
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
+
+if not API_KEY:
+    print("Error: MOLTFLOW_API_KEY environment variable not set")
+    exit(1)
+
+headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
+
+
+# ============================================================================
+# Custom Groups
+# ============================================================================
+
+def list_custom_groups(limit: int = 50, offset: int = 0):
+    """List all custom contact groups."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/custom-groups",
+        headers=headers,
+        params={"limit": limit, "offset": offset},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def create_custom_group(name: str, members: list = None):
+    """Create a new custom group. members = list of {"phone": str, "name": str?} dicts."""
+    data = {"name": name}
+    if members:
+        data["members"] = members
+    r = requests.post(f"{BASE_URL}/api/v2/custom-groups", headers=headers, json=data)
+    r.raise_for_status()
+    return r.json()
+
+
+def add_members(group_id: str, contacts: list):
+    """Add members to a custom group. contacts = list of {"phone": str} dicts."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/custom-groups/{group_id}/members/add",
+        headers=headers,
+        json={"contacts": contacts},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def export_group_csv(group_id: str):
+    """Export group members as CSV."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/custom-groups/{group_id}/export/csv",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.text
+
+
+def export_group_json(group_id: str):
+    """Export group members as JSON."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/custom-groups/{group_id}/export/json",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+# ============================================================================
+# Bulk Send
+# ============================================================================
+
+def create_bulk_job(session_id: str, custom_group_id: str, message_content: str):
+    """Create a bulk send job targeting a custom group."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/bulk-send",
+        headers=headers,
+        json={
+            "session_id": session_id,
+            "custom_group_id": custom_group_id,
+            "message_content": message_content,
+        },
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def list_bulk_jobs(limit: int = 50):
+    """List all bulk send jobs."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/bulk-send",
+        headers=headers,
+        params={"limit": limit},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def get_bulk_job(job_id: str):
+    """Get bulk job details and progress."""
+    r = requests.get(f"{BASE_URL}/api/v2/bulk-send/{job_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def pause_bulk_job(job_id: str):
+    """Pause a running bulk send job."""
+    r = requests.post(f"{BASE_URL}/api/v2/bulk-send/{job_id}/pause", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def resume_bulk_job(job_id: str):
+    """Resume a paused bulk send job."""
+    r = requests.post(f"{BASE_URL}/api/v2/bulk-send/{job_id}/resume", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def cancel_bulk_job(job_id: str):
+    """Cancel a bulk send job."""
+    r = requests.post(f"{BASE_URL}/api/v2/bulk-send/{job_id}/cancel", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+# ============================================================================
+# Scheduled Messages
+# ============================================================================
+
+def create_scheduled_message(
+    session_id: str,
+    custom_group_id: str,
+    message_content: str,
+    name: str = "Scheduled Message",
+    schedule_type: str = "one_time",
+    cron_expression: str = None,
+    timezone: str = "UTC",
+    scheduled_time: str = None,
+):
+    """Create a scheduled message.
+
+    schedule_type: one_time, daily, weekly, monthly, cron
+    scheduled_time: ISO 8601 datetime (required for 'one_time')
+    cron_expression: cron string (required for recurring types)
+    """
+    data = {
+        "session_id": session_id,
+        "custom_group_id": custom_group_id,
+        "message_content": message_content,
+        "name": name,
+        "schedule_type": schedule_type,
+        "timezone": timezone,
+    }
+    if scheduled_time:
+        data["scheduled_time"] = scheduled_time
+    if cron_expression:
+        data["cron_expression"] = cron_expression
+    r = requests.post(f"{BASE_URL}/api/v2/scheduled-messages", headers=headers, json=data)
+    r.raise_for_status()
+    return r.json()
+
+
+def list_scheduled_messages(limit: int = 50):
+    """List all scheduled messages."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/scheduled-messages",
+        headers=headers,
+        params={"limit": limit},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def pause_scheduled(message_id: str):
+    """Pause a scheduled message."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/scheduled-messages/{message_id}/pause",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def resume_scheduled(message_id: str):
+    """Resume a paused scheduled message."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/scheduled-messages/{message_id}/resume",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def cancel_scheduled(message_id: str):
+    """Cancel a scheduled message."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/scheduled-messages/{message_id}/cancel",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+if __name__ == "__main__":
+    print("MoltFlow Outreach")
+    print("=" * 40)
+
+    # Custom groups
+    groups = list_custom_groups()
+    group_list = groups.get("groups", groups) if isinstance(groups, dict) else groups
+    print(f"\nCustom Groups: {len(group_list) if isinstance(group_list, list) else 0}")
+
+    # Bulk jobs
+    jobs = list_bulk_jobs()
+    job_list = jobs.get("jobs", jobs) if isinstance(jobs, dict) else jobs
+    print(f"Bulk Jobs: {len(job_list) if isinstance(job_list, list) else 0}")
+
+    # Scheduled messages
+    scheduled = list_scheduled_messages()
+    sched_list = scheduled.get("messages", scheduled) if isinstance(scheduled, dict) else scheduled
+    print(f"Scheduled Messages: {len(sched_list) if isinstance(sched_list, list) else 0}")

package/scripts/quickstart.py

@@ -6,11 +6,11 @@ import os
 import requests
 
 API_KEY = os.environ.get("MOLTFLOW_API_KEY")
-BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://api.moltflow.com")
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
 
 if not API_KEY:
     print("Error: MOLTFLOW_API_KEY environment variable not set")
-    print("Get your API key at https://moltflow.com")
+    print("Get your API key at https://waiflow.app")
     exit(1)
 
 headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

package/scripts/reviews.py

@@ -6,7 +6,7 @@ import os
 import requests
 
 API_KEY = os.environ.get("MOLTFLOW_API_KEY")
-BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://api.moltflow.com")
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
 
 if not API_KEY:
     print("Error: MOLTFLOW_API_KEY environment variable not set")

package/scripts/send_message.py

@@ -1,38 +1,47 @@
 #!/usr/bin/env python3
 """
 Send WhatsApp Message Helper
-Wrapper around A2A Client for the most common task.
+Simple wrapper for the most common task — sending a text message via the REST API.
 """
 import argparse
+import os
 import sys
 import json
-from a2a_client import A2AClient
+import requests
+
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
+API_KEY = os.environ.get("MOLTFLOW_API_KEY")
+
 
 def main():
-    parser = argparse.ArgumentParser(description="Send WhatsApp message via A2A.")
-    parser.add_argument("--url", required=True, help="Full A2A API URL")
-    parser.add_argument("--key", required=True, help="API Key")
-    parser.add_argument("--to", required=True, help="Target phone number (e.g. 1234567890)")
+    parser = argparse.ArgumentParser(description="Send a WhatsApp message via MoltFlow API.")
+    parser.add_argument("--session", required=True, help="Session UUID")
+    parser.add_argument("--to", required=True, help="Target chat ID (e.g. 1234567890@c.us)")
     parser.add_argument("--text", required=True, help="Message text content")
-    
+    parser.add_argument("--key", default=API_KEY, help="API key (default: MOLTFLOW_API_KEY env)")
+
     args = parser.parse_args()
-    
-    client = A2AClient(args.url, args.key)
-    
-    # Construct standard A2A message payload
-    params = {
-        "phone": args.to,
-        "text": args.text
-    }
-    
-    response = client.send_rpc("message/send", params)
-    
-    # Output result
-    print(json.dumps(response, indent=2))
-    
-    # Exit code based on success
-    if "error" in response:
+
+    if not args.key:
+        print("Error: provide --key or set MOLTFLOW_API_KEY env var")
         sys.exit(1)
 
+    response = requests.post(
+        f"{BASE_URL}/api/v2/messages/send",
+        headers={"X-API-Key": args.key, "Content-Type": "application/json"},
+        json={
+            "session_id": args.session,
+            "chat_id": args.to,
+            "message": args.text,
+        },
+    )
+
+    result = response.json()
+    print(json.dumps(result, indent=2))
+
+    if not response.ok:
+        sys.exit(1)
+
+
 if __name__ == "__main__":
     main()