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: P-API - WhatsApp Connections Hub4---56# P-API - WhatsApp Connections Hub78910**The WhatsApp automation you've been waiting for.**1112Complete redesign with microservices architecture — modular, scalable, and independent.1314🌐 **Official Website:** https://papi.api.br 15🤝 **Partner:** [Mundo Automatik](https://mundoautomatik.com/)1617---1819## 📑 Table of Contents20211. [Features](#-features)222. [Configuration](#%EF%B8%8F-configuration)233. [Authentication](#-authentication)244. [Main Endpoints](#-main-endpoints)255. [Detailed References](#-detailed-references)266. [Credits](#-credits)2728---2930## ✨ Features3132### 📊 Admin Panel (Free)33- Multi-language interface (PT-BR, EN, ES)34- Instance management35- Real-time monitoring36- Behavior configuration37- Usage statistics3839### 🔥 Pro Features4041| 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 |4849---5051## ⚙️ Configuration5253Before using, configure in TOOLS.md:5455```markdown56### P-API (WhatsApp)57- Base URL: https://your-server.com58- API Key: your-api-key59- Default Instance: instance-name60```6162## 🔐 Authentication6364All requests require the `x-api-key` header:6566```bash67curl -X GET "https://your-server.com/api/instances" \68 -H "x-api-key: YOUR_KEY"69```7071---7273## 📡 Main Endpoints7475### Instances76| 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 |8384### Send Messages8586JID format: `5511999999999@s.whatsapp.net`8788| 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` |99100### Interactive Messages101102| 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 |108109### Groups110111| 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) |116117### Webhook118119```json120POST /api/instances/:id/webhook121{122 "url": "https://your-server/webhook",123 "enabled": true,124 "events": ["messages", "status"]125}126```127128---129130## 📚 Detailed References131132| 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 |138139---140141## 👥 Credits142143**Developed by:** Pastorini 144**Website:** https://papi.api.br 145**Partner:** [Mundo Automatik](https://mundoautomatik.com/) 146**Skill maintained by:** @rafacpti23