PAPI - WhatsApp API

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).

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

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:

### 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: [e-mail]

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