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