| name | p-api |
| description | 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. |
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
