工具概览
概览
Wasa 是一个轻量、无界面的 WhatsApp REST API，基于 @whiskeysockets/baileys，用于发送消息、媒体并管理连接会话。它通过 pnpm install 安装，并通过 PORT、API_KEY、SESSION_DIR 和 LOG_LEVEL 等环境变量配置。服务器可用 pnpm dev 以开发模式运行，或用 pnpm start 以生产模式运行。 关联 WhatsApp 账号时，Wasa 支持扫描终端中显示或通过 GET /api/session/qr 获取的二维码，也支持通过 POST /api/session/pair 请求 8 位配对码来配对。会话端点提供状态、群组、重启和登出功能。状态可能是 DISCONNECTED、CONNECTING、QR_READY 或 CONNECTED。 /api/messages 下的消息端点用于发送文本、媒体和批量消息。to 字段接受带国家区号的号码、已格式化的号码或 JID，并会自动规范化。文本发送支持在群组中 @ 提及。媒体发送支持通过 URL 或 Base64 发送图片、音频/语音消息、视频或文档。批量发送会把同一条消息发给一组收件人，并在每次发送之间加入延迟，以保护号码免遭封禁。 可通过在 .env 中设置 API_KEY 来启用可选的 API 密钥认证；启用后，对 /api/* 的请求必须携带 x-api-key 或 Authorization: Bearer。
功能特点
- AI 助手
- 自然语言界面
- 工作流自动化
相关标签
应用场景
团队用 Wasa 向单个 WhatsApp 号码或群组发送简单文本消息。
团队用 Wasa 通过 URL 或 Base64 发送图片、音频/语音消息、视频或文档。
团队用 Wasa 把同一条消息发给一组收件人，并在每次发送之间设置延迟。
团队用 Wasa 通过 8 位配对码关联 WhatsApp 账号，无需使用摄像头。
团队用 Wasa 列出已连接账号所在的全部群组，包括 ID、名称和成员数。
团队用 Wasa 查看会话状态。
团队用 Wasa 强制重启 WhatsApp 套接字连接。
团队用 Wasa 要求所有 /api/* 请求都带上 API 密钥请求头。