← Back to Skills Marketplace
SocialEpoch WhatsApp SCRM API
by
SocialEpochClaw
· GitHub ↗
· v2.1.8
· MIT-0
288
Downloads
4
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install socialepoch-whatsapp-scrm
Description
SocialEpoch WhatsApp SCRM open API, tailored for enterprise overseas marketing and customer service scenarios. Full coverage of WhatsApp account management,...
Usage Guidance
This skill appears to do what it claims (a WhatsApp SCRM client) and only requires the SocialEpoch tenant ID and API key. Before installing, consider: 1) The tool will save your API key to ~/.openclaw/scrm_config.json — treat that file as sensitive and remove or manage it if you rotate keys. 2) The script will attempt to auto-install the Python requests package via pip (may alter user/system packages); run in a controlled environment if you prefer. 3) SKILL.md says to run only in the skill directory, but the program reads/writes config in your home directory — be aware of this path. 4) Verify the API_BASE domain (api.socialepoch.com) and that you trust the service before supplying credentials. 5) If you need stronger isolation, run the skill in a sandbox, dedicated container, or machine account with minimal access. If you want more assurance, ask the publisher for a signed release or inspect the full untruncated scrm_api.py to confirm there are no additional network endpoints or hidden behavior.
Capability Analysis
Type: OpenClaw Skill
Name: socialepoch-whatsapp-scrm
Version: 2.1.8
The skill bundle is a legitimate integration for the SocialEpoch WhatsApp SCRM API, allowing for multi-account management and bulk messaging. It features automated dependency management in `scrm_api.py` (installing the 'requests' library via pip) and stores API credentials in a local configuration file at `~/.openclaw/scrm_config.json`. All network requests are directed to the official domain `api.socialepoch.com`, and the code lacks any indicators of data exfiltration, malicious prompt injection, or unauthorized persistence.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (WhatsApp SCRM) align with required env vars (SOCIALEPOCH_TENANT_ID, SOCIALEPOCH_API_KEY, SOCIALEPOCH_SOURCE), required binary (python3), and networked API calls to api.socialepoch.com. The API key as primary credential is expected for this purpose.
Instruction Scope
SKILL.md instructs running commands in the skill directory and describes config via env vars or set_config. The code, however, loads/saves config to a user home path (~/.openclaw/scrm_config.json) rather than the skill directory, which contradicts the 'do not search other paths' line in the doc. Aside from that mismatch, runtime behavior (making HTTPS requests, reading stated env vars, writing a local config, and only contacting api.socialepoch.com) stays within the described scope.
Install Mechanism
Declared install uses brew to ensure python3 — reasonable. The script also auto-installs the requests package at runtime via pip (subprocess.check_call) if missing; this is expected for a Python client but does perform network installs and can modify user/system packages depending on environment (the script passes --user and --break-system-packages on non-Windows). This is common but worth being aware of.
Credentials
Only three env vars are required (tenant id, API key, source). They are directly used by the client to sign and authenticate requests; no unrelated secrets or system credentials are requested.
Persistence & Privilege
The skill writes a config file to ~/.openclaw/scrm_config.json and merges prior values when saving — expected for persistent credentials. always is false. This writes to a user-wide location (home directory), which is normal for a CLI tool but means stored keys are persisted on disk and shared across runs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install socialepoch-whatsapp-scrm - After installation, invoke the skill by name or use
/socialepoch-whatsapp-scrm - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.8
- Updated description for improved clarity and conciseness.
- Version incremented to 2.1.8.
- No code or functional changes; documentation only.
v2.1.7
- Version bump from 2.1.6 to 2.1.7.
- No file or functionality changes detected; documentation and configuration remain unchanged.
- No new features, fixes, or updates introduced in this release.
v2.1.6
- Version bumped to 2.1.6.
- No code or documentation changes detected in this release.
v2.1.5
- Version bumped from 2.1.4 to 2.1.5.
- No code or functionality changes detected.
- Documentation and configuration instructions remain unchanged.
- Internal metadata updated to reflect the new version.
v2.1.4
- Added support for the SOCIALEPOCH_SOURCE environment variable to specify message send source (PC, Mobile, or Cloud).
- Updated documentation with detailed instructions for setting and using SOCIALEPOCH_SOURCE.
- Enhanced command examples and clarified agent query usage.
- System-level execution instructions added for improved reliability.
v2.1.3
- Updated documentation to English for broader accessibility.
- Clarified feature descriptions, command examples, and configuration steps.
- Adjusted operation rules to require explicit user instructions and authorization.
- Improved error handling section with friendlier guidance and adaptive retry notice.
- No code changes in this version; updates are documentation-only.
v2.1.2
- Updated description and documentation for greater clarity on supported features and command usage.
- Emphasized batch and single send support in message types and commands.
- Improved instructions in documentation for querying online agents.
- Made minor text and formatting enhancements in documentation for conciseness.
v2.1.1
Major update: Skill completely reworked with full official SocialEpoch WhatsApp SCRM API integration and CLI tool.
- Deprecated duplicate version replaced with official feature-complete release.
- Added scrm_api.py command-line tool supporting WhatsApp account management, message sending (all types), status queries, and batch actions.
- Automatic dependency installation and environment/config file dual-mode setup.
- Comprehensive error handling, input validation, and standardized JSON output.
- Updated documentation for commands, configuration, and usage scenarios.
v1.0.3
- Marked the skill as deprecated with a clear notice.
- Updated description and documentation to instruct users to use the correct skill (/socialepoch-wa-scrm).
- Removed redundant files: README.md and skill.json.
v1.0.2
- 新增 SocialEpoch WhatsApp SCRM 智能助手，官方原生对接 WA-SCRM 开放API。
- 支持零代码发送所有类型的WhatsApp消息（文字、图片、音频、文件、视频、名片、超链等）。
- 提供客户管理、用户画像、聊天记录查询、消息状态与账号在线状态查询功能。
- 支持设置 WebHook 回调、客户标签/备注、获取客户列表等操作。
- 所有API请求与参数严格遵循官方文档规范。
Metadata
Frequently Asked Questions
What is SocialEpoch WhatsApp SCRM API?
SocialEpoch WhatsApp SCRM open API, tailored for enterprise overseas marketing and customer service scenarios. Full coverage of WhatsApp account management,... It is an AI Agent Skill for Claude Code / OpenClaw, with 288 downloads so far.
How do I install SocialEpoch WhatsApp SCRM API?
Run "/install socialepoch-whatsapp-scrm" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SocialEpoch WhatsApp SCRM API free?
Yes, SocialEpoch WhatsApp SCRM API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does SocialEpoch WhatsApp SCRM API support?
SocialEpoch WhatsApp SCRM API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SocialEpoch WhatsApp SCRM API?
It is built and maintained by SocialEpochClaw (@socialepoch); the current version is v2.1.8.
More Skills