P-API - WhatsApp API

Automate WhatsApp messaging, interactive content, instance and group management, catalogs, and webhooks via a scalable microservices API with an admin panel.

Installieren
$clawhub install p-api

P-API - WhatsApp Connections Hub

P-API Logo

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: [email protected]

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