← Back to Skills Marketplace
PAPI - WhatsApp API
by
Rafa Martins
· GitHub ↗
· v1.0.0
2061
Downloads
2
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install papi
Description
Complete WhatsApp automation API with microservices architecture. Send messages, interactive buttons, lists, carousels, polls, manage instances, groups, catalogs and webhooks. Features Admin Panel (free), Phone Calls, RCS Messaging, SMS, Virtual Numbers (Pro).
README (SKILL.md)
PAPI - WhatsApp Connections Hub
The WhatsApp automation you've been waiting for.
Complete redesign with microservices architecture — modular, scalable, and independent.
🌐 Official Website: https://papi.api.br
🤝 Partner: Mundo Automatik
📑 Table of Contents
✨ Features
📊 Admin Panel (Free)
- Multi-language interface (PT-BR, EN, ES)
- Instance management
- Real-time monitoring
- Behavior configuration
- Usage statistics
🔥 Pro Features
| Feature | Capabilities |
|---|---|
| 📞 Phone Calls | Chip-based calls, WhatsApp calls, Extension system, Call management |
| 💬 RCS Messaging | Rich media sending, Buttons & carousels, Read receipts, Typing indicator |
| 📱 Call Center | Chip rotation (30 ports), Bulk SMS sending, Configurable rate limiting |
| ✉️ Professional SMS | Individual/bulk sending, Smart chip rotation, Port configuration |
| 🔢 Virtual Numbers | Instant purchase, Auto activation, Full management |
⚙️ Configuration
Before using, configure in TOOLS.md:
### PAPI (WhatsApp)
- Base URL: https://your-server.com
- API Key: your-api-key
- Default Instance: instance-name
🔐 Authentication
All requests require the x-api-key header:
curl -X GET "https://your-server.com/api/instances" \
-H "x-api-key: YOUR_KEY"
📡 Main Endpoints
Instances
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/instances |
List all instances |
| POST | /api/instances |
Create instance {"id": "name"} |
| GET | /api/instances/:id/qr |
Get QR code |
| GET | /api/instances/:id/status |
Instance status |
| DELETE | /api/instances/:id |
Remove instance |
Send Messages
JID format: [email protected]
| Type | Endpoint | Required Fields |
|---|---|---|
| Text | POST /send-text |
jid, text |
| Image | POST /send-image |
jid, url or base64, caption |
| Video | POST /send-video |
jid, url or base64 |
| Audio | POST /send-audio |
jid, url, ptt |
| Document | POST /send-document |
jid, url, filename |
| Location | POST /send-location |
jid, latitude, longitude |
| Contact | POST /send-contact |
jid, name, phone |
| Sticker | POST /send-sticker |
jid, url |
| Reaction | POST /send-reaction |
jid, messageId, emoji |
Interactive Messages
| Type | Endpoint | Description |
|---|---|---|
| Buttons | POST /send-buttons |
quick_reply, cta_url, cta_call, cta_copy |
| List | POST /send-list |
Menu with sections |
| Carousel | POST /send-carousel |
Sliding cards (mobile only) |
| Poll | POST /send-poll |
Voting up to 12 options |
Groups
| Method | Endpoint | Description |
|---|---|---|
| POST | /groups/create |
Create group |
| GET | /groups/:groupId/metadata |
Group info |
| POST | /groups/:groupId/participants |
Manage members (add/remove/promote/demote) |
Webhook
POST /api/instances/:id/webhook
{
"url": "https://your-server/webhook",
"enabled": true,
"events": ["messages", "status"]
}
📚 Detailed References
| File | Content |
|---|---|
references/interactive.md |
Buttons, lists, carousel, polls examples |
references/groups.md |
Group management |
references/catalog.md |
Product catalog |
references/integrations.md |
Typebot, Chatwoot integrations |
👥 Credits
Developed by: Pastorini
Website: https://papi.api.br
Partner: Mundo Automatik
Skill maintained by: @rafacpti23
Usage Guidance
This skill is basically documentation for a WhatsApp API and appears internally consistent with that purpose. Before installing or using it: 1) Confirm where you will host the 'Base URL' (the API server) and ensure you trust that server (https://papi.api.br is referenced); 2) Plan to provide an API key and any integration tokens (Chatwoot, Typebot) when you configure the skill — note the registry metadata doesn't declare these secrets, so the platform may not automatically request them; 3) If you will accept webhooks, make sure your webhook endpoint is secure and that you understand what events will be posted; 4) Verify compliance with WhatsApp Business policies and data-protection/regulatory requirements for sending messages and storing contact data; 5) If you need higher assurance, request the actual server/source code or a vetted release (signed GitHub release or official vendor package) rather than trusting only these docs.
Capability Analysis
Type: OpenClaw Skill
Name: papi
Version: 1.0.0
The skill bundle provides documentation for a WhatsApp automation API. All files describe API endpoints for messaging, group management, catalog features, and integrations. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the agent. All external URLs mentioned are for the stated service or its partner, or are placeholders for user-configured services, aligning with the stated purpose.
Capability Assessment
Purpose & Capability
The skill describes a WhatsApp automation API and all listed endpoints, features and integrations (instances, messages, groups, webhooks, catalog, Chatwoot/Typebot) match that purpose. Minor mismatch: the docs require a Base URL and an API Key but the skill metadata does not declare any required environment variables or a primary credential.
Instruction Scope
SKILL.md provides endpoint descriptions, example requests, webhook and integration configuration. The instructions do not ask the agent to read unrelated system files, environment variables, or to transmit data to unexpected endpoints beyond the documented API and user-provided webhooks.
Install Mechanism
No install specification and no code files are included (instruction-only), so nothing will be written to disk by the skill itself. This minimizes install-time risk.
Credentials
The documentation clearly expects an API Key and Base URL to be configured, and some integration examples require external tokens (e.g., Chatwoot token). However, the skill metadata lists no required env vars or primary credential—this inconsistency means the platform will not prompt for/validate secrets up front even though they are needed in practice.
Persistence & Privilege
The skill does not request persistent/always-on privileges (always: false) and contains no install steps that modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install papi - After installation, invoke the skill by name or use
/papi - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release with correct metadata format, emoji, homepage and tags
Metadata
Frequently Asked Questions
What is PAPI - WhatsApp API?
Complete WhatsApp automation API with microservices architecture. Send messages, interactive buttons, lists, carousels, polls, manage instances, groups, catalogs and webhooks. Features Admin Panel (free), Phone Calls, RCS Messaging, SMS, Virtual Numbers (Pro). It is an AI Agent Skill for Claude Code / OpenClaw, with 2061 downloads so far.
How do I install PAPI - WhatsApp API?
Run "/install papi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PAPI - WhatsApp API free?
Yes, PAPI - WhatsApp API is completely free (open-source). You can download, install and use it at no cost.
Which platforms does PAPI - WhatsApp API support?
PAPI - WhatsApp API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PAPI - WhatsApp API?
It is built and maintained by Rafa Martins (@rafacpti23); the current version is v1.0.0.
More Skills