papi
by rafacpti23
Web & Frontend DevelopmentBrief
Complete WhatsApp automation API with microservices architecture.
Description
What This Skill Does
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.
Combines instance management, all WhatsApp message types, group administration, and webhook configuration in one API instead of requiring multiple separate services.
When to Use It
- Send automated order confirmation messages to customers via WhatsApp
- Build a customer support bot with interactive button and list menus
- Manage multiple WhatsApp instances from a single API
- Run group polls with up to 12 voting options
- Trigger WhatsApp notifications from external events via webhooks
Example Workflow
User asks: Send an interactive button message to a customer on WhatsApp
- 1
Create or connect a WhatsApp instance via POST /api/instances
- 2
Retrieve QR code from GET /api/instances/:id/qr to authenticate the phone
- 3
Format the recipient JID as 5511999999999@s.whatsapp.net
- 4
Send the button message via POST /send-buttons with jid, text, and button configuration
- 5
Configure a webhook via POST /api/instances/:id/webhook to receive button response events
Customer receives a WhatsApp message with interactive buttons; button taps are delivered to the configured webhook URL
Requirements
- PAPI server instance (self-hosted or provided by papi.api.br)
- PAPI API key for the x-api-key header, obtained from your server configuration
- Pro subscription at papi.api.br for phone calls, RCS messaging, SMS, and virtual numbers
Installation
clawhub install rafacpti23/papiRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.