PAPI:WhatsApp 自动化与微服务 API - Openclaw Skills

作者:互联网

2026-03-24

AI教程

什么是 PAPI - WhatsApp 连接枢纽?

PAPI 是一个全面的 WhatsApp 自动化中心,采用现代微服务架构设计,以确保模块化、可扩展性和独立性。它使开发人员能够将先进的消息传递功能集成到其工作流程中,包括发送交互式按钮、列表、轮播图和投票的能力。作为 Openclaw Skills 生态系统的强大补充,PAPI 在您的应用程序与 WhatsApp 生态系统之间提供了可靠的桥梁。

除了标准的消息传递,PAPI 还提供专业功能,例如用于实时坚控和实例管理的管理面板。这使其成为寻求通过集中式高性能 API 自动化客户支持、营销活动或内部通知的企业的理想解决方案。其架构专门为处理海量消息而构建,同时保持多个实例的稳定性。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rafacpti23/papi

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install papi

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 papi。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

PAPI - WhatsApp 连接枢纽 应用场景

  • 使用交互式按钮和列表自动响应客户支持请求。
  • 向客户发送批量通知和营销轮播图。
  • 以编程方式管理 WhatsApp 群组成员和元数据。
  • 通过短信或 WhatsApp 消息实施双因素身份验证。
  • 使用实时 Webhook 将 WhatsApp 交互与 CRM 系统集成。
PAPI - WhatsApp 连接枢纽 工作原理
  1. 通过 PAPI 管理界面或 API 创建新实例来初始化连接。
  2. 使用唯一的 x-api-key 标头对所有后续请求进行身份验证以确保安全。
  3. 获取并扫描生成的二维码,将实体 WhatsApp 设备连接到数字实例。
  4. 使用 RESTful 接口执行文本、媒体或交互式元素的各种消息传递或管理命令。
  5. 通过可配置的 Webhook 器接收并处理实时更新和消息事件。

PAPI - WhatsApp 连接枢纽 配置指南

在使用此技能之前,请确保您已准备好 Base URL 和 API Key。按如下方式配置您的环境:

# 列出活动实例以验证连接的示例
curl -X GET "https://your-server.com/api/instances" r
  -H "x-api-key: YOUR_API_KEY"

# 以编程方式创建新实例
curl -X POST "https://your-server.com/api/instances" r
  -H "x-api-key: YOUR_API_KEY" r
  -H "Content-Type: application/json" r
  -d '{"id": "my-instance-01"}'

PAPI - WhatsApp 连接枢纽 数据架构与分类体系

PAPI 技能围绕实例和消息类型组织数据,以确保通过 Openclaw Skills 协议高效交付:

组件 数据字段 描述
实例 ID, 状态, 二维码数据 每个 WhatsApp 账号的唯一标识符和连接状态。
消息 JID, 负载, 类型 目标接收者 ID (JID) 和具体内容结构(文本、图像等)。
交互式 按钮, 列表, 投票 聊天界面内 UI 元素的结构化数据。
Webhooks URL, 事件列表 配置事件触发时推送数据的位置和内容。
name: papi
description: 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).
metadata: {"openclaw":{"emoji":"??","homepage":"https://papi.api.br","tags":["p-api","papi","whatsapp","automation","messaging","api"]}}

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

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" r
  -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: 5511999999999@s.whatsapp.net

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