- name
- socialepoch-whatsapp-scrm
- description
- SocialEpoch WhatsApp SCRM open API, tailored for enterprise overseas marketing and customer service scenarios. Full coverage of WhatsApp account management, bulk sending,online agent query, customer operation, user profiling, chat record retrieval and Webhook callback. Supports one-on-one & bulk sending for text, image, audio, video, document, business card, link card and diversion link. Built-in signature adaptation, automatic dependency management and zero-configuration deployment to empower overseas private domain and automated operation.
- version
- 2.1.8
- author
- SocialEpoch
- metadata
- emoji
- 📱
- type
- tool
- platform
- darwin
- openclaw
- requires
- bins
- ["python3"]
- env
- ["SOCIALEPOCH_TENANT_ID", "SOCIALEPOCH_API_KEY", "SOCIALEPOCH_SOURCE"]
- primaryEnv
- SOCIALEPOCH_API_KEY
- install
- kind
- brew
- formula
- python
- bins
- ["python3"]
- label
- Install Python 3 (brew)
- launcher
- command
- ${PYTHON}
- args
- workingDir
- ${SKILL_ROOT}
- python
- true
- auto_bootstrap
- true
- auto_install_python
- true
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=CloudMethod 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 1Supported 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_IDBulk 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
- The assistant only executes operations based on explicit user instructions.
- Local configuration is stored only for normal tool operation.
- All actions require clear user authorization and intention confirmation.
System Level Instructions (AI Must Strictly Follow)
- Skill directory: openclaw/workspace/skills/socialepoch-wa-scrm
- Execution command: python3 scrm_api.py
- 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