> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 企业微信

> 在企业微信中接入和使用专家

将你的 AI 专家接入企业微信，让团队成员在企业微信对话中直接使用专家。企业微信渠道采用独特的「编辑模式」消息投递——回复内容在一条消息内实时更新，阅读体验更加流畅。

## 接入方式

<AccordionGroup>
  <Accordion title="扫码快速接入（推荐）">
    几分钟完成配置：

    1. 在专家 Studio 的「渠道接入」中选择企业微信
    2. 点击「扫码接入」
    3. 使用企业微信管理员账号扫描二维码
    4. 确认授权，系统自动完成配置
    5. 在企业微信中搜索应用名开始测试
  </Accordion>

  <Accordion title="手动配置">
    需要精细控制权限时选择手动方式：

    <Steps>
      <Step title="创建企业微信应用">
        登录[企业微信管理后台](https://work.weixin.qq.com)，进入「应用管理」→「自建」→ 创建应用。填写应用名称、图标和可见范围。
      </Step>

      <Step title="配置接收消息">
        在应用详情的「接收消息」设置中，开启 API 接收消息。将袋袋提供的回调 URL 填入，同时记录下 Token 和 EncodingAESKey。
      </Step>

      <Step title="获取凭证">
        记录应用的 AgentId，以及企业的 CorpId 和应用 Secret。
      </Step>

      <Step title="填入袋袋">
        将 CorpId、AgentId、Secret、Token 和 EncodingAESKey 全部填入袋袋的渠道配置面板。
      </Step>

      <Step title="验证回调">
        保存配置后，企业微信会向回调地址发送验证请求。袋袋服务会自动完成验证。
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## 消息投递：编辑模式

企业微信渠道的消息风格与其他平台不同：

<Note>
  企业微信采用「编辑模式」（StreamBridge）——专家的回复在**同一条消息中实时更新**，而非发送多条消息气泡。类似于你在网页端看到的打字机效果。
</Note>

### 编辑模式的优势

| 特点         | 说明            |
| ---------- | ------------- |
| **减少通知打扰** | 不会因多条消息产生反复提醒 |
| **阅读连贯**   | 回复内容在同一位置持续更新 |
| **进度可见**   | 能看到专家正在实时输出内容 |

### 工具调用展示

当专家调用工具时，消息内容会更新为当前执行状态（如「搜索中...」），完成后替换为最终回复内容。整个过程在一条消息内完成。

## 使用方式

### 应用内对话

在企业微信的「工作台」中找到配置好的应用，点击进入对话界面，直接发送消息。

### 单聊

在通讯录中找到应用机器人，发送消息开始一对一对话。

<Tip>
  企业微信的编辑模式特别适合需要长回复的场景（如文档生成、分析报告），因为回复不会被拆分成多条消息。
</Tip>

## 配置步骤详解（手动模式）

<Steps>
  <Step title="企业微信管理后台创建应用">
    在「应用管理」→「自建」中创建应用，设置：

    * 应用名称（建议与专家名称一致）
    * 应用图标
    * 可见范围（选择哪些部门/人员可以使用）
  </Step>

  <Step title="开启 API 接收消息">
    进入应用详情 →「接收消息」→ 设置 API 接收：

    * URL：填入袋袋提供的回调地址
    * Token：自动生成或自定义
    * EncodingAESKey：自动生成或自定义
  </Step>

  <Step title="配置可信域名">
    在「企业可信 IP」中添加袋袋服务的出口 IP（如有需要）。
  </Step>

  <Step title="提交袋袋配置">
    在袋袋专家 Studio 的渠道配置中填入所有凭证，点击保存。
  </Step>

  <Step title="测试">
    在企业微信中给应用发送测试消息，确认收到正常回复。
  </Step>
</Steps>

## 注意事项

<Warning>
  * 企业微信应用创建需要管理员权限
  * 可见范围决定了哪些员工能使用此专家
  * 编辑模式下，消息更新频率受企业微信 API 限制，极快的连续更新可能被节流
</Warning>

## 常见问题

<AccordionGroup>
  <Accordion title="消息验证失败">
    确认 Token 和 EncodingAESKey 在袋袋配置和企业微信配置中完全一致。注意不要有多余的空格。
  </Accordion>

  <Accordion title="应用看不到/找不到">
    确认你的企业微信账号在应用的「可见范围」内。如果刚修改了可见范围，可能需要等待几分钟生效。
  </Accordion>

  <Accordion title="回复内容不完整">
    企业微信单条消息有字数限制。如果专家的回复超过限制，会在达到限制时截断。建议在专家配置中适当控制回复长度。
  </Accordion>
</AccordionGroup>

## 相关页面

<CardGroup cols={2}>
  <Card title="渠道总览" icon="layer-group" href="/zh/documentation/channels/overview">
    了解所有 IM 平台概况
  </Card>

  <Card title="微信接入" icon="message" href="/zh/documentation/channels/wechat">
    微信公众号渠道配置
  </Card>
</CardGroup>