> ## 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 专家接入微信，让用户通过微信公众号或服务号与专家对话。微信渠道面向 C 端用户，适合需要通过微信触达终端用户的场景。

## 适用场景

微信渠道特别适合：

* **客服场景**：用户通过公众号获取 AI 客服支持
* **知识咨询**：关注公众号后随时提问获取专业解答
* **服务通知**：结合公众号模板消息提供主动服务

<Note>
  微信渠道主要面向通过公众号触达的 C 端用户。如果你的目标是企业内部协作，推荐使用企业微信渠道。
</Note>

## 接入方式

微信渠道通过微信公众号（服务号）接入：

<Steps>
  <Step title="准备公众号">
    你需要一个已认证的微信服务号（订阅号部分接口受限）。登录[微信公众平台](https://mp.weixin.qq.com)。
  </Step>

  <Step title="开启开发者模式">
    进入公众号「设置与开发」→「基本配置」，启用开发者模式。记录 AppID 和 AppSecret。
  </Step>

  <Step title="配置服务器">
    在「服务器配置」中：

    * URL：填入袋袋提供的消息回调地址
    * Token：自定义一个验证 Token
    * EncodingAESKey：随机生成
    * 消息加解密方式：选择安全模式
  </Step>

  <Step title="填入袋袋">
    在专家 Studio 的渠道配置中填入 AppID、AppSecret、Token 和 EncodingAESKey。
  </Step>

  <Step title="启用并测试">
    保存配置后，在微信中关注公众号并发送测试消息。
  </Step>
</Steps>

## 消息格式

微信渠道采用文本消息回复：

* 专家的回复以纯文本或图文消息形式发送
* 支持基础文本格式
* 工具调用过程对用户透明，用户只看到最终结果
* 超长回复可能被分段发送

<Tip>
  微信消息有 5 秒响应限制。如果 AI 处理时间超过 5 秒，系统会使用客服消息接口异步回复，用户会在处理完成后收到推送。
</Tip>

## 功能范围

### 完整支持

| 能力   | 说明          |
| ---- | ----------- |
| 多轮对话 | 上下文记忆和连续对话  |
| 工具调用 | 搜索、知识库等基础工具 |
| 技能生效 | 已安装的技能正常工作  |
| 统一计费 | 消耗用户袋袋账户积分  |

### Web 端专属（IM 不支持）

以下功能仅在袋袋网页端可用：

* 沙盒代码执行和预览
* 文件树浏览
* 网站生成与预览面板
* 多面板工作区布局
* 文件上传和实时协作编辑

<Warning>
  微信渠道的用户需要先在袋袋网页端注册账号并绑定微信，才能正常使用专家并进行计费。未绑定的用户会收到引导注册的提示。
</Warning>

## 用户身份关联

微信渠道需要将微信用户与袋袋账户关联：

<AccordionGroup>
  <Accordion title="自动关联">
    如果用户的袋袋账户已绑定微信号，系统会自动识别并关联。对话积分从该用户的袋袋账户扣除。
  </Accordion>

  <Accordion title="引导注册">
    未关联的微信用户发送消息时，会收到引导注册/绑定的提示信息，包含注册链接和操作指引。
  </Accordion>
</AccordionGroup>

## 注意事项

<Warning>
  * 微信公众号接口需要已认证的服务号
  * 订阅号虽然可接入，但部分主动推送能力受限
  * 微信对消息频率有限制，高并发场景需注意接口配额
  * 开发者模式启用后，自动回复等公众号原生功能将失效
</Warning>

## 常见问题

<AccordionGroup>
  <Accordion title="公众号不回复消息">
    * 确认已启用开发者模式
    * 确认服务器配置验证已通过
    * 确认袋袋渠道配置中的凭证信息正确
    * 检查是否因超时触发了异步回复模式
  </Accordion>

  <Accordion title="回复延迟很大">
    微信消息如果处理时间超过 5 秒会走异步回复路径，用户体感上可能有数秒到十几秒的等待。这与 AI 模型推理时间和工具调用有关，属于正常现象。
  </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/wecom">
    企业微信渠道配置
  </Card>
</CardGroup>