| name | 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). |
| metadata | {"openclaw":{"emoji":"📱","homepage":"https://papi.api.br","tags":["p-api","papi","whatsapp","automation","messaging","api"]}} |
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
- Configuration
- Authentication
- Main Endpoints
- Detailed References
- Credits
✨ 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: 5511999999999@s.whatsapp.net
| 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
