Installation

clawhub install rafacpti23/papi

Summary

PAPI is a WhatsApp automation API built on a microservices architecture. It handles sending messages of all types (text, media, interactive buttons, polls, carousels), managing WhatsApp instances and groups, and configuring webhooks. A Pro tier adds phone calls, RCS messaging, bulk SMS, and virtual number management.

SKILL.md

PAPI - WhatsApp Connections Hub

PAPI 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

FeatureCapabilities
πŸ“ž Phone CallsChip-based calls, WhatsApp calls, Extension system, Call management
πŸ’¬ RCS MessagingRich media sending, Buttons & carousels, Read receipts, Typing indicator
πŸ“± Call CenterChip rotation (30 ports), Bulk SMS sending, Configurable rate limiting
βœ‰οΈ Professional SMSIndividual/bulk sending, Smart chip rotation, Port configuration
πŸ”’ Virtual NumbersInstant purchase, Auto activation, Full management

βš™οΈ Configuration

Before using, configure in TOOLS.md:

markdown
### 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:

bash
curl -X GET "https://your-server.com/api/instances" \
  -H "x-api-key: YOUR_KEY"

πŸ“‘ Main Endpoints

Instances

MethodEndpointDescription
GET/api/instancesList all instances
POST/api/instancesCreate instance {"id": "name"}
GET/api/instances/:id/qrGet QR code
GET/api/instances/:id/statusInstance status
DELETE/api/instances/:idRemove instance

Send Messages

JID format: 5511999999999@s.whatsapp.net

TypeEndpointRequired Fields
TextPOST /send-textjid, text
ImagePOST /send-imagejid, url or base64, caption
VideoPOST /send-videojid, url or base64
AudioPOST /send-audiojid, url, ptt
DocumentPOST /send-documentjid, url, filename
LocationPOST /send-locationjid, latitude, longitude
ContactPOST /send-contactjid, name, phone
StickerPOST /send-stickerjid, url
ReactionPOST /send-reactionjid, messageId, emoji

Interactive Messages

TypeEndpointDescription
ButtonsPOST /send-buttonsquick_reply, cta_url, cta_call, cta_copy
ListPOST /send-listMenu with sections
CarouselPOST /send-carouselSliding cards (mobile only)
PollPOST /send-pollVoting up to 12 options

Groups

MethodEndpointDescription
POST/groups/createCreate group
GET/groups/:groupId/metadataGroup info
POST/groups/:groupId/participantsManage members (add/remove/promote/demote)

Webhook

json
POST /api/instances/:id/webhook
{
  "url": "https://your-server/webhook",
  "enabled": true,
  "events": ["messages", "status"]
}

πŸ“š Detailed References

FileContent
references/interactive.mdButtons, lists, carousel, polls examples
references/groups.mdGroup management
references/catalog.mdProduct catalog
references/integrations.mdTypebot, Chatwoot integrations

πŸ‘₯ Credits

Developed by: Pastorini
Website: https://papi.api.br
Partner: Mundo Automatik
Skill maintained by: @rafacpti23

Recommended skills

Browse all β†’

Related guides

Hand-picked reading to help you choose, install, and use agent skills.