企业微信机器人 - 快速安装指南

安装步骤

1. 创建数据库表

执行SQL文件创建必要的数据库表：

# 方法1：使用MySQL命令行
mysql -u用户名 -p密码 数据库名 < app/Database/wework_bot.sql
方法2：使用phpMyAdmin
1. 登录phpMyAdmin
2. 选择数据库
3. 点击"导入"
4. 选择 app/Database/wework_bot.sql 文件
5. 点击"执行"
方法3：直接执行SQL
打开 app/Database/wework_bot.sql 文件
复制所有SQL语句
在数据库管理工具中执行

SQL文件会创建以下表：

• wework_bot - 机器人配置表
• wework_conversation - 对话记录表

2. 验证安装

访问后台管理系统，检查左侧菜单是否出现「企业微信机器人」选项：

系统配置
  ├─ 模板管理
  ├─ API管理
  ├─ 企业微信机器人  ← 新增菜单
  ├─ AI配置
  ├─ RAG管理
  └─ 系统设置

3. 配置企业微信

参考《企业微信机器人使用说明.md》完成企业微信应用的创建和配置。

文件清单

安装完成后，系统包含以下文件：

后端控制器

• app/Controllers/Admin/Wework.php - 后台管理控制器
• app/Controllers/Wework.php - 企业微信回调处理控制器

视图文件

• app/Views/admin/wework/index.php - 机器人列表页
• app/Views/admin/wework/edit.php - 机器人编辑页
• app/Views/admin/wework/logs.php - 对话日志页
• app/Views/admin/wework/stats.php - 统计分析页

数据库

• app/Database/wework_bot.sql - 数据库表结构

路由配置

// 后台管理路由
admin/wework              - 机器人列表
admin/wework/add          - 添加机器人
admin/wework/edit/:id     - 编辑机器人
admin/wework/save         - 保存机器人
admin/wework/delete       - 删除机器人
admin/wework/toggle       - 启用/禁用
admin/wework/test         - 测试连接
admin/wework/logs         - 对话日志
admin/wework/stats        - 统计分析
// 企业微信回调路由
wework/callback/:token    - 接收企业微信消息

功能特性

✅ 多机器人管理 - 支持创建多个机器人，对接不同应用 ✅ 智能路由 - 根据置信度自动决定是否转人工 ✅ 工作模式 - 智能路由/全自动/混合三种模式 ✅ 对话日志 - 完整记录所有对话历史 ✅ 数据统计 - 对话量、置信度、高频问题等分析 ✅ 可视化配置 - 后台界面化配置，无需修改代码

系统要求

• PHP 7.4+
• MySQL 5.7+ / MariaDB 10.2+
• CodeIgniter 4
• 已配置AI模型（用于智能问答）
• 已创建知识空间和文档
• HTTPS域名（企业微信要求）

快速测试

1. 创建测试机器人

机器人名称：测试机器人
机器人标识：test-bot
CorpId：你的企业ID
AgentId：你的应用ID
Secret：你的应用密钥
Token：随机生成的Token
EncodingAESKey：随机生成的密钥
知识空间：选择一个已有空间
AI模型：选择已配置的模型
工作模式：全自动

2. 配置企业微信回调

URL：https://你的域名/wework/callback/test-bot
Token：与机器人配置中的Token一致
EncodingAESKey：与机器人配置中的密钥一致

3. 发送测试消息

在企业微信应用中发送"你好"，机器人应该会自动回复。

故障排查

问题1：菜单不显示

• 清除浏览器缓存
• 检查路由配置是否正确
• 确认已更新 app/Views/admin/layout/header.php

问题2：数据库表不存在

• 确认已执行 app/Database/wework_bot.sql
• 检查数据库连接配置
• 查看数据库是否有权限创建表

问题3：回调验证失败

• 确认URL可以从外网访问
• 检查Token和EncodingAESKey是否一致
• 查看服务器错误日志

问题4：机器人不回复

• 检查机器人是否已启用
• 确认AI配置正常
• 查看对话日志是否有记录
• 检查知识空间是否有内容

下一步

安装完成后，请阅读《企业微信机器人使用说明.md》了解详细的配置和使用方法。

技术支持

如遇到问题，请检查：

版本：v1.0.0 更新时间：2024-01-20