WhatsApp 详细配置

1. 前置准备

需要一个可用的 WhatsApp 账号（手机号）。确保 Node.js 已安装（Baileys 桥接需要）。首次连接需要通过手机扫描二维码或输入配对码完成认证。认证状态会持久化到 ~/.semibot/channels/whatsapp/<instance_id>/auth/ 目录。

2. 在 Semibot 创建实例

进入 Semibot 配置中心 > Bots > 新建，选择 WhatsApp 类型。填写 sessionName（会话标识）、linkedPhone（可选，关联手机号如 +8613800138000）、defaultPhone（可选，默认发送目标号码）。选择默认 Agent，保存实例。

3. 配对认证

实例创建后，Semibot 会启动 Baileys 桥接进程。首次启动时需要完成 WhatsApp Web 认证：桥接进程会生成二维码或配对码，使用手机 WhatsApp 扫描完成绑定。认证成功后凭据会自动保存，后续重启无需重新认证。实例模式需设为 gateway、bridge 或 baileys。

4. 群聊 ID 说明

WhatsApp 群聊的 chat_id 格式为 <number>@g.us（如 120363xxx@g.us），个人聊天格式为 <number>@s.whatsapp.net。出站消息通过文件队列（outbox 目录）发送，桥接进程会自动拾取并发送。

5. 联调与验证

1. 在 Semibot 中点击「测试」确认出站链路可达。2. 在 WhatsApp 中向 Bot 发送消息。3. 在 Semibot 事件中心确认收到入站事件。4. 在会话详情查看执行记录和回传结果。常见错误：桥接进程未启动（检查 Node.js 和实例模式）、认证过期（重新扫码配对）、消息未送达（检查 outbox 目录权限）。