WhatsApp 设置
将您的 Claw Buff 智能体连接到 WhatsApp 的分步指南
WhatsApp 集成目前为测试版。它使用 WhatsApp Web 协议（Baileys），不是官方 API。请查看下方重要说明。
将您的 Claw Buff AI 智能体连接到 WhatsApp，让用户像普通联系人一样与其聊天。设置大约需要 5 分钟。
前置条件
- 一个 WhatsApp 账号（强烈建议使用独立手机号）
- 用于扫码的智能手机
- 已部署的 Claw Buff 智能体（快速开始）
第一步：连接到 Claw Buff
- 打开 Claw Buff 控制台 → 渠道页面
- 找到 WhatsApp 卡片，点击连接
- 点击生成二维码
屏幕上将显示一个二维码。
第二步：扫描二维码
打开手机上的 WhatsApp
打开右上角 ⋮ 菜单或设置，点击已关联的设备 → 关联设备。部分版本可以直接点击设置页头像旁的二维码图标。
扫描二维码
将手机摄像头对准控制台中显示的二维码。连接将自动建立。
确认连接
控制台将显示状态为已连接。您会看到已链接的手机号码。
第三步：开始聊天
从任何其他 WhatsApp 账号向已链接的号码发送消息。您的 AI 智能体会立即回复！
我们建议为 WhatsApp 机器人使用独立手机号。这可以将您的个人 WhatsApp 隔离开来，避免个人账号受到任何风险。
功能特性
| 功能 | 支持情况 |
|---|---|
| 私聊 | 支持 |
| 群组聊天 | 支持 |
| 富文本格式 | 支持 |
| 文件附件 | 支持 |
| 语音消息 | 计划中 |
重要说明
测试版状态
WhatsApp 集成使用 Baileys 库（WhatsApp Web 协议）。这不是官方 WhatsApp API，这意味着：
- 账号风险 — WhatsApp 可能限制使用非官方 API 的账号。请使用独立号码，而非个人号
- 会话过期 — 链接会话在约 30 天不活跃后会过期，需要重新扫码
- 无 SLA — WhatsApp 的协议变更可能会暂时中断连接
独立号码建议
我们强烈建议为 WhatsApp 机器人获取一个独立手机号。选项包括：
- 预付费 SIM 卡
- Google Voice 号码
- 可接收短信验证的 VoIP 号码
Cloud API 替代方案
对于需要官方 API 的生产用例，WhatsApp Cloud API 支持已在规划中。这将使用 Meta 的官方 Business API，提供正式的 SLA 保障，无账号风险。
常见问题
1. 二维码过期了？
二维码约 60 秒后过期。在控制台中点击生成二维码即可获取新的。
2. 连接频繁断开？
- 确保手机保持联网
- 检查 WhatsApp 是否已更新到最新版本
- 如果手机长时间离线，可能需要重新链接会话
3. 消息未送达？
- 检查收件人号码是否为 E.164 格式（如 +15551234567）
- 群组消息需要机器人号码是群组成员
- 在控制台渠道页面查看错误详情