A technical reference and workflow guide for implementing programmatic WhatsApp messaging through the Meta Cloud API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whatsapp-cloud-api-reference
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install whatsapp-cloud-api-reference using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WhatsApp Cloud API Messaging Skill?
This skill provides a comprehensive technical framework for developers to integrate WhatsApp messaging into their applications using the Meta Cloud API. It centralizes critical knowledge regarding the WhatsApp Business Platform, including the mandatory use of pre-approved templates for initial contact and the mechanics of the 24-hour free-form messaging window. By leveraging this Openclaw Skills documentation, developers can ensure their AI agents or backend services communicate reliably while adhering to Meta's strict delivery policies.
The skill covers everything from initial environment setup and token management to advanced media handling and interactive message components. It is designed to help developers avoid common pitfalls like silent delivery failures, incorrect webhook verification, and rate limiting issues that often plague early-stage integrations.
WhatsApp Cloud API Messaging Skill Use Cases
- Automating transactional notifications such as order confirmations and shipping updates using pre-approved templates.
- Building AI-powered customer support bots that respond to user-initiated queries within the 24-hour window.
- Programmatically sending rich media including invoices, images, and video demonstrations to opted-in customers.
- Real-time monitoring of message engagement through delivered and read status webhooks.
How WhatsApp Cloud API Messaging Skill Works
- The system initiates a connection by utilizing a permanent System User token with specific messaging and management permissions.
- For first-time outreach, the skill formats a request using a pre-approved Meta template to initiate a conversation.
- Upon receiving a user reply, a 24-hour window opens, allowing the application to send free-form text messages.
- A webhook listener captures incoming messages and delivery status updates (sent, delivered, read, failed) in real-time.
- The workflow monitors the WhatsApp Business Account quality rating to ensure high delivery rates and prevent account restrictions.
WhatsApp Cloud API Messaging Skill Setup
To begin using this Openclaw Skills resource, ensure you have a Meta Developer App configured with the WhatsApp product. Follow these steps:
- Generate a permanent System User token in the Meta Business Manager with
whatsapp_business_messagingandwhatsapp_business_managementpermissions. - Register your business phone number via the Meta dashboard or API.
- Configure a public HTTPS webhook endpoint to receive message events.
Use the following command to verify your phone number status:
curl "https://graph.facebook.com/v21.0/YOUR_PHONE_NUMBER_ID?fields=status,quality_rating" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
WhatsApp Cloud API Messaging Skill Data Schema & Taxonomy
The skill organizes messaging data according to the Meta Graph API specifications:
| Data Type | Description | Key Fields |
|---|---|---|
| Messaging Payload | Structure for outbound messages | messaging_product, to, type, template/text |
| Status Object | Delivery tracking metadata | id, status (delivered/read), timestamp |
| Media Constraints | Requirements for attachments | link (HTTPS), provider (Public), size_limit (16MB-100MB) |
| Error Codes | Diagnostic metadata for failures | code (e.g., 131047), message, error_subcode |
WhatsApp Cloud API Messaging Skill Advanced Features
- Implementation of exponential backoff logic and message queuing to handle API rate limits (80 MPS default).
- Interactive messaging capabilities including Quick Reply buttons and List Menus for enhanced user experience.
- Automated quality rating checks to monitor the health of the WhatsApp Business Account programmatically.
- Asynchronous webhook processing patterns to ensure high-performance message handling without blocking the API response.
SKILL.md
Loading
Related Openclaw Skills
Self-Improvement Skill
A persistent learning framework that captures errors, corrections, and best practices to enable continuous improvement for AI coding agents.
Deep Dialogue System
A sophisticated multi-agent system designed for deep self-exploration through conversational coaching, personality profiling, and structured session synthesis.
Firm VS Bridge Pack
A powerful bridge utility for synchronizing code context and editor session states between VS Code and the OpenClaw Gateway.
Firm Suppliers Pack
A comprehensive procurement toolkit for AI agents to handle supplier sourcing, TCO analysis, and risk monitoring.
Deep Private Search
A secure, VPN-mandated search skill using local SearXNG for multi-iteration private research without tracking or rate limits.
privatedeepsearch-melt
A privacy-obsessed deep research assistant that performs multi-round web searches and synthesizes cited reports using local SearXNG instances.
Featured*
