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
1---2name: papi3description: 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).4---5
6# PAPI - WhatsApp Connections Hub
7
8
9
10**The WhatsApp automation you've been waiting for.**
11
12Complete redesign with microservices architecture — modular, scalable, and independent.
13
14🌐 **Official Website:** https://papi.api.br
15🤝 **Partner:** [Mundo Automatik](https://mundoautomatik.com/)
16
17---
18
19## 📑 Table of Contents
20
211. [Features](#-features)
222. [Configuration](#%EF%B8%8F-configuration)
233. [Authentication](#-authentication)
244. [Main Endpoints](#-main-endpoints)
255. [Detailed References](#-detailed-references)
266. [Credits](#-credits)
27
28---
29
30## ✨ Features
31
32### 📊 Admin Panel (Free)
33- Multi-language interface (PT-BR, EN, ES)
34- Instance management
35- Real-time monitoring
36- Behavior configuration
37- Usage statistics
38
39### 🔥 Pro Features
40
41| Feature | Capabilities |
42|---------|--------------|
43| 📞 **Phone Calls** | Chip-based calls, WhatsApp calls, Extension system, Call management |
44| 💬 **RCS Messaging** | Rich media sending, Buttons & carousels, Read receipts, Typing indicator |
45| 📱 **Call Center** | Chip rotation (30 ports), Bulk SMS sending, Configurable rate limiting |
46| ✉️ **Professional SMS** | Individual/bulk sending, Smart chip rotation, Port configuration |
47| 🔢 **Virtual Numbers** | Instant purchase, Auto activation, Full management |
48
49---
50
51## ⚙️ Configuration
52
53Before using, configure in TOOLS.md:
54
55```markdown
56### PAPI (WhatsApp)
57- Base URL: https://your-server.com
58- API Key: your-api-key
59- Default Instance: instance-name
60```
61
62## 🔐 Authentication
63
64All requests require the `x-api-key` header:
65
66```bash
67curl -X GET "https://your-server.com/api/instances" \
68 -H "x-api-key: YOUR_KEY"
69```
70
71---
72
73## 📡 Main Endpoints
74
75### Instances
76| Method | Endpoint | Description |
77|--------|----------|-------------|
78| GET | `/api/instances` | List all instances |
79| POST | `/api/instances` | Create instance `{"id": "name"}` |
80| GET | `/api/instances/:id/qr` | Get QR code |
81| GET | `/api/instances/:id/status` | Instance status |
82| DELETE | `/api/instances/:id` | Remove instance |
83
84### Send Messages
85
86JID format: `5511999999999@s.whatsapp.net`
87
88| Type | Endpoint | Required Fields |
89|------|----------|-----------------|
90| Text | `POST /send-text` | `jid`, `text` |
91| Image | `POST /send-image` | `jid`, `url` or `base64`, `caption` |
92| Video | `POST /send-video` | `jid`, `url` or `base64` |
93| Audio | `POST /send-audio` | `jid`, `url`, `ptt` |
94| Document | `POST /send-document` | `jid`, `url`, `filename` |
95| Location | `POST /send-location` | `jid`, `latitude`, `longitude` |
96| Contact | `POST /send-contact` | `jid`, `name`, `phone` |
97| Sticker | `POST /send-sticker` | `jid`, `url` |
98| Reaction | `POST /send-reaction` | `jid`, `messageId`, `emoji` |
99
100### Interactive Messages
101
102| Type | Endpoint | Description |
103|------|----------|-------------|
104| Buttons | `POST /send-buttons` | quick_reply, cta_url, cta_call, cta_copy |
105| List | `POST /send-list` | Menu with sections |
106| Carousel | `POST /send-carousel` | Sliding cards (mobile only) |
107| Poll | `POST /send-poll` | Voting up to 12 options |
108
109### Groups
110
111| Method | Endpoint | Description |
112|--------|----------|-------------|
113| POST | `/groups/create` | Create group |
114| GET | `/groups/:groupId/metadata` | Group info |
115| POST | `/groups/:groupId/participants` | Manage members (add/remove/promote/demote) |
116
117### Webhook
118
119```json
120POST /api/instances/:id/webhook
121{
122 "url": "https://your-server/webhook",
123 "enabled": true,
124 "events": ["messages", "status"]
125}
126```
127
128---
129
130## 📚 Detailed References
131
132| File | Content |
133|------|---------|
134| `references/interactive.md` | Buttons, lists, carousel, polls examples |
135| `references/groups.md` | Group management |
136| `references/catalog.md` | Product catalog |
137| `references/integrations.md` | Typebot, Chatwoot integrations |
138
139---
140
141## 👥 Credits
142
143**Developed by:** Pastorini
144**Website:** https://papi.api.br
145**Partner:** [Mundo Automatik](https://mundoautomatik.com/)
146**Skill maintained by:** @rafacpti23
modbender