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

1. Features
2. Configuration
3. Authentication
4. Main Endpoints
5. Detailed References
6. 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