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

Security Scan

This is an instruction-only skill documenting a WhatsApp automation API; its contents and examples align with the claimed purpose, but there are small metadata inconsistencies you should note before using it.

Purpose & Capability

The skill describes a WhatsApp automation API and all listed endpoints, features and integrations (instances, messages, groups, webhooks, catalog, Chatwoot/Typebot) match that purpose. Minor mismatch: the docs require a Base URL and an API Key but the skill metadata does not declare any required environment variables or a primary credential.

Instruction Scope

SKILL.md provides endpoint descriptions, example requests, webhook and integration configuration. The instructions do not ask the agent to read unrelated system files, environment variables, or to transmit data to unexpected endpoints beyond the documented API and user-provided webhooks.

Install Mechanism

No install specification and no code files are included (instruction-only), so nothing will be written to disk by the skill itself. This minimizes install-time risk.

Credentials

The documentation clearly expects an API Key and Base URL to be configured, and some integration examples require external tokens (e.g., Chatwoot token). However, the skill metadata lists no required env vars or primary credential—this inconsistency means the platform will not prompt for/validate secrets up front even though they are needed in practice.

Persistence & Privilege

The skill does not request persistent/always-on privileges (always: false) and contains no install steps that modify other skills or global agent settings.

Assessment

This skill is basically documentation for a WhatsApp API and appears internally consistent with that purpose. Before installing or using it: 1) Confirm where you will host the 'Base URL' (the API server) and ensure you trust that server (https://papi.api.br is referenced); 2) Plan to provide an API key and any integration tokens (Chatwoot, Typebot) when you configure the skill — note the registry metadata doesn't declare these secrets, so the platform may not automatically request them; 3) If you will accept webhooks, make sure your webhook endpoint is secure and that you understand what events will be posted; 4) Verify compliance with WhatsApp Business policies and data-protection/regulatory requirements for sending messages and storing contact data; 5) If you need higher assurance, request the actual server/source code or a vetted release (signed GitHub release or official vendor package) rather than trusting only these docs.

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