← Back to Skills Marketplace
23569
Downloads
60
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install whatsapp-business
Description
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. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install this only if you are comfortable connecting a WhatsApp Business account through Maton. Confirm the exact recipient, message body, account connection, and payload before any send, template change, media deletion, or profile update. Prefer OAuth over API keys, and use the raw HTTP fallback only when the CLI and SDK cannot run.
Capability Assessment
Credentials
Network access, OAuth, and access to the connected WhatsApp Business account are proportionate to the integration, though users should recognize that sends and deletes affect real recipients, account reputation, and business data.
Install Mechanism
Installation is limited to documented Maton CLI or optional SDK package installs, with no bundled executable scripts or hidden install behavior in the artifact.
Instruction Scope
The skill uses a generic API passthrough that can technically reach more than the documented endpoints, but it explicitly defines a reviewed boundary, says not to probe or invent endpoints, and requires user approval for undocumented or write operations.
Persistence & Privilege
The skill discloses persistent OAuth/profile storage in the operating system credential store and gives explicit instructions not to read, print, export, or persist credentials elsewhere; no background worker or autonomous persistence is present.
Purpose & Capability
Its capabilities match the stated purpose: WhatsApp Business messages, media, templates, phone numbers, and business profile operations through the Maton gateway.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install whatsapp-business - After installation, invoke the skill by name or use
/whatsapp-business - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 23569 downloads so far.
How do I install WhatsApp Business?
Run "/install whatsapp-business" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is WhatsApp Business free?
Yes, WhatsApp Business is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does WhatsApp Business support?
WhatsApp Business is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created WhatsApp Business?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.2.
More Skills