← 返回 Skills 市场
byungkyu

WhatsApp Business

作者 byungkyu · GitHub ↗ · v1.2.9 · MIT-0
cross-platform ✓ 安全检测通过
24521
总下载
61
收藏
0
当前安装
17
版本数
在 OpenClaw 中安装
/install whatsapp-business
功能描述
WhatsApp Business API integration with managed OAuth. Send messages, manage templates, and handle conversations. Use this skill when users want to interact with WhatsApp Business. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a WhatsApp Business connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a WhatsApp Business action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with WhatsApp Business examples; they add no WhatsApp Business capability - WhatsApp Business is not an event source, a trigger cannot read WhatsApp Business data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
安全使用建议
Before installing, understand that this skill can send real WhatsApp messages to real people and may incur business, privacy, or reputation impact. Use it only with the intended WhatsApp Business account, confirm every recipient and write action, avoid broad or persistent automation unless you explicitly need it, and do not expose Maton or provider credentials in files, logs, headers, or prompts.
能力评估
ℹ Credentials
The skill requires network access, a Maton account, OAuth/browser authorization, and Bash use, which are proportionate for a managed API integration. Raw HTTP with a long-lived API key is documented only as a last resort with handling cautions.
✓ Install Mechanism
Installation is disclosed and uses pinned Maton CLI/package versions or a pinned Homebrew install; no hidden install scripts or embedded executable payloads were present.
✓ Instruction Scope
The skill repeatedly narrows agent behavior to documented WhatsApp Business endpoints, defaults to read/list operations, requires explicit approval for writes, connection creation, hosted functions, trigger destinations, and local event execution, and treats third-party content as untrusted data.
ℹ Persistence & Privilege
OAuth tokens are stored in the OS credential store and Maton functions/triggers/destinations can persist beyond a single session, but this is disclosed with approval, least-privilege, deletion, and credential-handling guidance.
✓ Purpose & Capability
The documented capabilities fit the stated purpose: connecting a WhatsApp Business account, reading/listing account resources, sending messages, managing templates/media/profile details, and optionally using Maton functions/triggers for user-approved automation.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install whatsapp-business
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /whatsapp-business 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.2.9
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.8
- Updated WhatsApp Business API version in usage examples from v21.0 to v25.0 for compatibility with the latest API. - Removed the redundant skill-card.md file for clarity and maintenance. - No other functional or documentation changes were introduced.
v1.2.7
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.6
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.5
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.4
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.3
Harden every multipart upload example: the assembled request body now goes to an owner-only file created with umask 077 and mktemp, removed by a trap on any exit, instead of a predictable shared /tmp path that could be pre-created by another user and left behind holding a copy of the uploaded file
v1.2.2
Resolve remaining audit findings: state one consistent endpoint policy instead of conflicting scope claims, qualify the local-execution and high-impact wording, note that locale examples are illustrative, and correct app-specific auth, method and upload-path documentation
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.1
- Removed the sample file skill-card.md. - No other functional or documentation changes in this patch.
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.4
- Changed all endpoint URLs from *.maton.ai/gateway and *.maton.ai/ctrl to *.maton.ai/api. - Updated examples and documentation to use the new https://api.maton.ai base URL for WhatsApp Business API and connection management. - Added a Security & Permissions section clarifying access scope and user approval requirements for write operations. - Removed LICENSE.txt file from the project.
v1.0.3
- Added metadata specifying required environment variable: MATON_API_KEY. - Included emoji indicator in the metadata for identification. - No changes to code or core functionality.
v1.0.2
- Documentation formatting corrections in SKILL.md for improved readability. - No functional or API changes in this version.
v1.0.1
- Added a reference to the api-gateway skill in the description for interactions with other third party apps. - Updated all Quick Start and connection management examples to use Python scripts instead of curl. - Changed environment variable usage in documentation from `YOUR_API_KEY` to `$MATON_API_KEY` for improved consistency. - Minor clarity and style adjustments throughout documentation.
v1.0.0
Initial release of WhatsApp Business API integration. - Provides managed OAuth authentication via Maton. - Supports sending messages (text, templates, media, location, contacts, interactive types). - Enables message template management. - Allows connection management (create, list, delete, specify via header). - Proxy gateway to WhatsApp Business API using Maton API key for authentication. - Includes example cURL commands and detailed usage instructions.
元数据
Slug whatsapp-business
版本 1.2.9
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 17
常见问题

WhatsApp Business 是什么?

WhatsApp Business API integration with managed OAuth. Send messages, manage templates, and handle conversations. Use this skill when users want to interact with WhatsApp Business. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a WhatsApp Business connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a WhatsApp Business action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with WhatsApp Business examples; they add no WhatsApp Business capability - WhatsApp Business is not an event source, a trigger cannot read WhatsApp Business data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 24521 次。

如何安装 WhatsApp Business?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install whatsapp-business」即可一键安装,无需额外配置。

WhatsApp Business 是免费的吗?

是的,WhatsApp Business 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

WhatsApp Business 支持哪些平台?

WhatsApp Business 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 WhatsApp Business?

由 byungkyu(@byungkyu)开发并维护,当前版本 v1.2.9。

💬 留言讨论