# CATO 企业微信自建应用接入指南

适用于 CATO V2.16.0。

## 管理员配置

1. 在企业微信管理后台创建自建应用，记下 CorpID、AgentID 和应用 Secret。
2. 登录 CATO 管理员账号，打开「控制中心」→「消息渠道」→「企业微信自建应用」。
3. 填写 CorpID、AgentID、Secret、自定义 Token，以及企业微信生成的 43 位 EncodingAESKey。
4. 启用并保存，复制 CATO 生成的「接收消息 URL」。
5. 回到企业微信自建应用的「接收消息」设置，粘贴 URL，并填写完全相同的 Token 和 EncodingAESKey。
6. 设置应用可见范围。若后台要求可信 IP，填写 CATO 服务器公网 IP。

## 用户绑定

1. 用户登录自己的 CATO 网页账号。
2. 打开「控制中心」→「个人与绑定」→「绑定企业微信」。
3. 生成绑定码。
4. 在企业微信 CATO 应用中发送完整绑定码。
5. 收到绑定成功提示后即可聊天和接收提醒。

CATO 会自动读取企业微信成员 UserID，用户不需要手工填写。

## 使用方式

- 企业微信文字会进入该用户自己的 CATO 对话。
- CATO 先发送猫咪等待动作，再发送正式 AI 与工具执行结果。
- 回复「完成任务名」可完成任务。
- 回复「打卡 习惯名」可完成习惯打卡。
- 任务和习惯到期后可主动发送企业微信提醒。

## 排错

- 回调保存失败：检查 HTTPS、URL、Token、EncodingAESKey 和 Nginx `/api/` 转发。
- 能看到应用但不回复：检查应用可见范围、接收消息设置和绑定状态。
- 查看日志：`sudo journalctl -u cato -n 100 --no-pager`
- 「测试连接」仅验证 CorpID 与 Secret；回调仍需单独完成 URL 验证。

Secret、Token、EncodingAESKey 不会通过读取接口回显。随机绑定码 10 分钟有效，自定义绑定码 24 小时有效，绑定后立即失效。