乐享知识库接口文档

# 操作指引

# 步骤一：创建企业微信智能机器人

# 1.1 进入智能机器人管理

登录企业微信管理后台 (opens new window)，进入安全与管理 >> 管理工具，点击智能机器人。

进入智能机器人

# 1.2 创建机器人

点击创建机器人按钮。

创建机器人

# 1.3 填写基本信息

填写机器人头像、名称、简介，并设置可见范围。

填写机器人信息

# 1.4 切换为 API 模式

下拉至创建页面底部，点击切换为 API 模式创建。

切换API模式

# 1.5 获取接口凭证

点击随机获取按钮，生成 Token 和 Encoding-AESKey。

获取Token和AESKey

# 步骤二：配置乐享机器人对接信息

# 2.1 进入集成对接页面

登录乐享知识库-管理后台 (opens new window)，进入AI助手 >> 集成对接，点击对接企业微信机器人 - 立即对接。

进入集成对接

# 2.2 选择企业 ID

在企业 ID 下拉框中，选择需要对接企业微信智能机器人的企业。

选择企业ID

若当前乐享知识库集成了多个企业微信，如何选择企业 ID？
登录企业微信管理后台 (opens new window)，进入我的企业 >> 企业信息，即可查看企业 ID。

获取企业ID

# 2.3 填写机器人对接信息

根据步骤一中创建的企业微信智能机器人信息，填写以下参数：

  • 机器人名称
  • Token（步骤 1.5 中获取）
  • Encoding-AESKey（步骤 1.5 中获取）

填写对接信息

# 2.4 生成回调地址

点击保存并生成信息，系统将生成 AI 问答回调的服务器地址（URL）。

生成回调地址

回调地址示例

# 步骤三：配置 AI 问答回调地址

根据企业微信认证状态，配置方式有所不同：

# 方式 A：未认证企业（直接配置）

✅ 适用于：未完成企业微信认证的企业

直接使用乐享提供的默认域名，无需额外配置代理转发。

操作步骤：

  1. 复制步骤 2.4 中生成的服务器地址（URL）
  2. 将 URL 中的 {企业域名} 替换为 qywechat-aibot.lexiang-app.com
  3. 将替换后的完整 URL 填入企业微信智能机器人的回调地址配置中

# 方式 B：已认证企业（需配置域名代理）

⚠️ 适用于：已完成企业微信认证的企业（需开发/运维支持）

需要准备一个已备案的企业域名作为代理服务器，将企微请求转发至腾讯乐享。

# 3.1 配置 Nginx 代理转发

Nginx 配置示例：

server {
    listen      443 ssl; # 为安全起见，建议使用 HTTPS 协议，也可支持其他端口如 8080、10443 等
    server_name www.example.com; # 替换为您已备案的域名
    
    location ~ ^/qywechat-ai-bots/ {
        proxy_pass https://qywechat-aibot.lexiang-app.com;
        proxy_http_version 1.1;
        proxy_buffering off;
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

配置说明：

  • server_name: 替换为您企业已备案的域名
  • listen: 可根据实际情况调整端口（如 8080、10443 等）
  • 配置完成后，请重启 Nginx 服务

# 3.2 填写回调地址

  1. 复制步骤 2.4 中生成的服务器地址（URL）
  2. 将 URL 中的 {企业域名} 替换为您配置的域名

注意： 如果配置了非标准端口（非 443），请在域名后加上端口号，例如：www.example.com:8080

填写回调地址

替换示例：

URL替换示例

# 3.3 完成配置

点击确定完成机器人创建，即可在企业微信中添加智能机器人使用。

完成配置

← 效果体验 →