SemibotWhatsApp 详细配置
通过 Baileys 桥接连接 WhatsApp Web，适合个人聊天和群聊场景。
1. 前置准备
你需要一个可用的 WhatsApp 账号，并且本机上已经装好 Node.js，因为 Baileys 桥接会用到。第一次连接时，要通过手机扫码或输入配对码来完成认证。认证状态会保存在 ~/.semibot/channels/whatsapp/<instance_id>/auth/ 目录里。
2. 在 Semibot 创建实例
打开 Semibot 配置中心，进入 Bots > 新建，选择 WhatsApp。填好 sessionName；如果你想固定关联手机号或默认发送目标，也可以把 linkedPhone 和 defaultPhone 一起填上。选好默认智能体后保存。
3. 配对认证
实例创建后，Semibot 会拉起 Baileys 桥接进程。第一次启动时会出现二维码或配对码，用手机上的 WhatsApp 完成绑定就行。绑好以后凭据会自动保存，后面重启通常不用再配一次。
4. 群聊 ID 说明
WhatsApp 群聊的 chat_id 一般是 <number>@g.us，个人聊天则是 <number>@s.whatsapp.net。出站消息会先进 outbox 队列，再由桥接进程自动发出去。
5. 联调与验证
先在 Semibot 里点「测试」，确认链路通了。再去 WhatsApp 里给机器人发一条消息，到事件中心看有没有收到入站事件，最后在会话详情里确认执行过程和回传结果。最常见的问题是桥接进程没起来、认证失效，或者 outbox 没有正常发出去。
FAQ
WhatsApp 接入最容易卡在哪里？
通常是桥接进程没正常运行、二维码配对失效，或者实例模式没配对。建议先确认桥接服务状态，再重新配对一次。
为什么能连上但消息发不出去？
常见原因是出站目录权限有问题、默认发送目标没配好，或者桥接会话已经失效。可以先看运行日志确认是哪一步卡住。
这个接入方式适合什么场景？
更适合个人或小团队把 AI 助手带进 WhatsApp 日常沟通场景里。如果你已经习惯用 WhatsApp 处理事务，这种方式会更顺手。