SocialEpoch WhatsApp SCRM API

SocialEpoch WhatsApp SCRM open API, tailored for enterprise overseas marketing and customer service scenarios. Full coverage of WhatsApp account management,...

SocialEpoch WhatsApp SCRM Intelligent Assistant

Comprehensive management for WhatsApp service accounts. Support one-on-one and bulk delivery of text, images, audio, videos, documents, business cards and link messages, with online agent query and automatic signature. No manual dependency installation or environment configuration required. Clear guidance will be prompted when configuration is missing.

Core Features

• 📱 Cross-platform compatibility: Native adaptation for Mac
• 📦 Dependency management: Automatic detection and installation of requests
• 🔧 Dual configuration: Environment variables & local config file
• ✅ Strict validation: Format, non-empty and type checking for all parameters
• 📊 Structured output: Standardized JSON response for all results
• 🚀 Send source support: PC(1), Mobile(2), Cloud(3), default to PC(1)

Send Source Description

• 1 = PC (Default)
• 2 = Mobile
• 3 = Cloud

Configuration Methods (Choose One)

Method 1: Environment Variables (Recommended)

export SOCIALEPOCH_TENANT_ID="Your Tenant ID"
export SOCIALEPOCH_API_KEY="Your API Key"
export SOCIALEPOCH_SOURCE="1"  # 1=PC,2=Mobile,3=Cloud

Method 2: Command Line Configuration

# Default source = 1 (PC)
python3 scrm_api.py set_config Your_Tenant_ID Your_API_Key

# Custom source (1=PC,2=Mobile,3=Cloud)
python3 scrm_api.py set_config Your_Tenant_ID Your_API_Key 1

Supported Commands

Query Online Agent Accounts

# Query all online agents
python3 scrm_api.py query_online_agents

# Query specified agent by user account (optional)
python3 scrm_api.py query_online_agents "your_user_account"

Send Text Message

python3 scrm_api.py send_text Sender_Number Recipient_Number "Message Content"

Send Image

python3 scrm_api.py send_img Sender_Number Recipient_Number "Image URL" "Remark"

Send Audio

python3 scrm_api.py send_audio Sender_Number Recipient_Number "Audio URL"

Send Document

python3 scrm_api.py send_file Sender_Number Recipient_Number "File URL" "Remark"

Send Video

python3 scrm_api.py send_video Sender_Number Recipient_Number "Video URL" "Remark"

Send Business Card

python3 scrm_api.py send_card Sender_Number Recipient_Number "Card Content"

Send Brand Link Card

python3 scrm_api.py send_card_link Sender_Number Recipient_Number "Title" "Link URL" "Description" "Cover Image URL"

Send Diversion Link

python3 scrm_api.py send_flow_link Sender_Number Recipient_Number "Title" "Diversion Number List"

Query Task Status

python3 scrm_api.py query_task Task_ID

Bulk Messaging

Bulk delivery is available for text, image, video, audio, document and link card messages. Separate multiple recipient numbers with an English comma (,).

Operation Rules

1. The assistant only executes operations based on explicit user instructions.
2. Local configuration is stored only for normal tool operation.
3. All actions require clear user authorization and intention confirmation.

System Level Instructions (AI Must Strictly Follow)

1. Skill directory: openclaw/workspace/skills/socialepoch-wa-scrm
2. Execution command: python3 scrm_api.py
3. Always execute from the skill directory; do not search other paths.

Error Handling

• Missing dependencies → Friendly installation prompt
• Missing configuration → Clear setup guidance
• Invalid parameters → Usage reminder
• Network exception → Adaptive retry mechanism