const loginSupport = () => YundaDesk.login({
  getToken: () => fetch('/support/identity', { credentials: 'same-origin' })
    .then(response => {
      if (!response.ok) throw new Error('Identity request failed');
      return response.json();
    })
    .then(({ token }) => token),
});
if (window.YundaDesk?.login) loginSupport();
else window.addEventListener('yundadesk:ready', loginSupport, { once: true });

<script src="https://cdn.yundadesk.com/widget.js" data-yd-key="yd_widget_main" async></script>

连接后，客户发给企业官方“微信客服帐号”的消息会进入 YundaDesk 工作台，人工坐席和 AI 客服可以在企业微信允许的会话范围内回复。

微信客服不是普通企微员工账号。普通企微员工与外部联系人的私聊、客户群消息和内部聊天不会进入这个渠道。

企业与工作区的连接关系#

一个 YundaDesk 工作区可以连接多个企业。对于同一个 YundaDesk 第三方应用，一家企业一次只能连接一个 YundaDesk 工作区。这是整个企业的连接关系，不是某个客服帐号的连接关系。

• 当前工作区连接企业 A 后，还可以继续授权企业 B；各企业的帐号、渠道和连接状态彼此独立。
• 同一工作区可以为同一企业重新授权。
• 如果“授权新企业”时选择了当前工作区已连接的同一企业，YundaDesk 会更新原有企业连接，不会创建重复项。
• 如果其他工作区再次为该企业扫码授权，页面只会提示“该企业已连接其他工作区”，不会转移连接，也不会显示原工作区的信息。
• 原工作区必须先完成企业级解除和数据清理，其他工作区才能连接该企业。

开始前准备#

你需要：

• YundaDesk 渠道管理权限；如需解除整个企业连接，还需工作区管理员身份；
• 可以安装第三方应用并管理微信客服帐号的企业微信管理员；
• 至少一个已在企业微信管理后台创建的微信客服帐号；
• 一个用于真实收发测试的个人微信账号；
• 当前工作区的“渠道”页面已显示微信客服，且当前套餐包含该渠道。

先了解完整流程#

页面上方的交互演示可以快速预览 YundaDesk 内的授权、同步和启用步骤；下面的截图对应真实企业微信后台。

1. 在企业微信创建微信客服帐号#

使用企业微信管理员登录管理后台，打开“应用管理”，进入“微信客服”。确认微信客服应用已启用，并检查可见范围。

选择“创建帐号”，设置头像和对外展示名称。一个企业可以创建多个客服帐号；后续每个导入 YundaDesk 的帐号都会成为一个独立渠道。

企业微信原生机器人、原生人工接待人员、欢迎语和自动结束时间由企业微信管理。它们不是 YundaDesk 的坐席配置。如果企业微信原生人工接手会话，YundaDesk 会同步展示相关消息，但当前会话会进入只读状态。

2. 在 YundaDesk 授权企业#

1. 在 YundaDesk 打开“渠道”。
2. 要连接新企业，在渠道市场选择“微信客服”。该入口始终开始一份新的企业授权，不会自动打开或重新授权已有连接。
3. 选择“前往企业微信授权”。YundaDesk 会在新页面打开授权，原工作台不会离开当前页面。
4. 使用企业微信管理员完成安装授权，并同意页面列出的企业信息、企业员工信息和微信客服权限。完成后授权页会回到 YundaDesk，原工作台也会自动刷新企业连接状态。

“为你提供专属客服”是企业微信提供的服务商联系选项，不决定微信客服消息是否能够接入；可按企业需要选择。完成授权后返回 YundaDesk，等待企业授权状态变为“已连接”。

管理多个企业连接#

在“渠道”左侧导航中展开“微信客服”，可以看到当前工作区连接的全部企业。微信客服右侧数字是全部已导入客服帐号渠道数，企业右侧数字是该企业已导入的帐号渠道数。选择企业后会展开该企业的已导入帐号，并显示企业详情；“同步帐号”“重新授权”“启用帐号”和“解除企业连接”等操作只作用于当前所选企业。选择具体帐号则打开该帐号的渠道详情。

要继续接入另一家企业，返回渠道市场选择“微信客服”，并完成新的企业微信授权。如果管理员选择了当前工作区已经连接的同一企业，YundaDesk 会更新原连接并提示“已更新现有企业授权”，不会增加重复连接。如果该企业属于另一个工作区，仍需由原工作区先完成企业解除和数据清理。

3. 在企业微信授予帐号管理权限#

企业授权完成后，YundaDesk 可以发现客服帐号，但只有被明确授权的帐号才能由 YundaDesk 管理和收发消息。

在企业微信管理后台打开“应用管理 → 微信客服”，滚动到“通过 API 管理会话消息”，选择“授权给第三方应用”。

在 YundaDesk 应用所在行打开操作菜单，选择“授权客服帐号”。

勾选需要接入的客服帐号并确认。一个客服帐号同时只能交由一个第三方应用管理时，应先解除原应用的管理关系。

企业微信后台的菜单名称可能随版本调整。请确认授权对象是“微信客服帐号”，不是普通成员、客户联系或客户群权限。

4. 同步、选择并启用帐号#

返回 YundaDesk，在渠道导航中展开“微信客服”，选择刚授权的企业，再选择“同步帐号”。刚完成企业授权、但尚未分配 API 管理权时，帐号会显示“无管理权限”。

完成企业微信侧授权后再次同步，帐号会变为“可管理”。勾选需要接入的帐号，然后选择“启用所选账号”。

启用所选帐号会：

• 为每个微信客服帐号创建一个独立的 YundaDesk 渠道；
• 按客服帐号区分会话来源；
• 允许该帐号的消息进入统一工作台；
• 立即启用渠道，允许在官方会话限制内由人工回复。

AI 回复默认关闭，因此页面会同时显示“已启用”和“关闭 AI 回复”。如需 AI 自动接待，请再到 AI 客服的接待设置中选择对应渠道。渠道启停与 AI 回复是两个独立状态。

查看帐号同步状态#

启用帐号后，打开对应微信客服渠道的详情页，可以看到彼此独立的同步信息：

“最近帐号列表同步”和“最近消息同步”用途不同，时间不一致是正常的。短时网络波动不会立即显示为需要处理的连接异常；消息仍在恢复时，帐号健康状态会显示“正在同步”。

如果页面显示“连接异常”并出现“最近需处理错误码”，请先选择“同步帐号”。如果同步立即成功且异常消失，无需重新授权；如果异常持续存在，再检查企业授权和帐号管理权限，并按页面提示重新授权或联系 YundaDesk 支持。

5. 完成真实收发测试#

1. 在企业微信管理后台取得客服帐号 A 的接入链接或二维码。
2. 用个人微信账号打开入口并发送一条带唯一标记的测试消息。
3. 在 YundaDesk 工作台确认新会话显示正确的微信客服帐号来源。
4. 从工作台发送人工回复，并在个人微信中确认真实收到。
5. 如已启用 AI 接待，再由客户发送一条新消息，确认 AI 回复真实送达。
6. 对客服帐号 B 重复测试，确认两组会话来源不会混淆。

后台显示“已发送”不等于客户已经最终收到。验收应以客户微信中的实际消息为准，并留意稍后出现的异步发送失败状态。

如果工作区连接了多个企业，还应分别用两个企业中的客服帐号完成双向收发测试，并确认会话来源、重新授权和连接状态不会跨企业混淆。

接入边界和回复限制#

微信客服要求客户先发起会话。普通 API 回复同时受以下限制：

• 只能在客户最近一次发送消息后的 48 小时内回复；
• 当前回复窗口内最多发送 5 条消息；
• 客户再次发送新消息后，回复窗口和可用条数会重新计算；
• 企业微信原生客服接手、会话结束或帐号异常时，YundaDesk 不能继续普通发送。

YundaDesk 内部的坐席分配不会改变企业微信原生接待状态。客户看到的发送身份始终是对应的微信客服帐号。

支持的消息#

YundaDesk 可以显示客户发来的文本、常用媒体以及部分结构化卡片。工作台出站支持文本、图片、语音、视频和文件；是否能够发送仍取决于当前会话状态、回复窗口和官方限制。

如果微信昵称可以从官方资料中取得，工作台会优先显示昵称；否则显示“微信客户 #编号”作为稳定兜底。

同步、重新授权和解除连接#

先确认要操作的是单个客服帐号，还是哪个企业连接：

单帐号页面中的“解除接入”或“删除帐号”都不等于企业级解除。即使删除了全部客服帐号，企业仍与当前工作区保持连接，除非完成下面的企业级解除流程。

解除整个企业连接#

只有同时具备工作区管理员身份和渠道管理权限的成员可以执行此操作。

1. 打开“渠道”，展开“微信客服”，选择要解除的企业，再选择“解除企业连接”。
2. 按页面提示输入企业名称并确认。YundaDesk 会立即停用该企业下的全部微信客服渠道；消息收发、帐号同步和新帐号启用都会停止。
3. 由企业管理员打开企业微信管理后台，进入“应用管理 → 第三方应用 → YundaDesk”，选择“删除应用”。
4. 返回 YundaDesk，选择“我已删除，检查状态”，并再次确认已经删除应用。
5. 如果企业微信仍显示应用已授权，页面会继续等待，不会开始清理。确认应用已删除后，YundaDesk 会进入“正在解除连接并清理数据”。
6. 等待该企业从连接列表中消失。此时该企业才可以连接当前工作区或其他工作区。

解除只影响当前所选企业。工作区中的其他企业连接及其已启用渠道会继续运行。

如果尚未在企业微信中删除应用，可以选择“取消解除”。YundaDesk 会重新验证授权，并只恢复发起解除前处于启用状态的渠道；原本手动停用的渠道不会被开启。如果企业微信授权已经失效，则不能取消解除。

企业微信侧主动撤销#

如果企业管理员直接在企业微信后台删除 YundaDesk 应用，YundaDesk 收到撤销通知后会立即停用该企业的全部微信客服渠道，并开始清理。清理完成前，该企业仍归当前工作区所有，不能连接到另一个工作区。

每个企业连接状态代表什么#

如果清理暂时失败，该企业会继续显示未完成的清理状态，系统会安全重试。完成前不会从列表中消失，企业也不会被其他工作区接走；其他企业连接不受影响。

清理完成后会发生什么#

企业级解除会清理或匿名化该微信客服连接产生的可识别数据，包括客服帐号资料、微信客户身份、渠道消息内容和微信客服专属附件。为保持报表连续性，会话和汇总统计可能保留不含身份与消息内容的结构，消息位置会显示统一的已清理提示。

如果同一客户还通过网站、Email、另一家微信客服企业或其他渠道联系过你，这些身份和历史不会因本次企业解除而删除。该企业从连接列表中消失后，才表示微信客服数据清理和企业归属释放均已完成。

故障排查#

提示“该企业已连接其他工作区”#

重复扫码不会转移企业连接。请联系原工作区管理员完成企业级解除，并等待清理完成后再重试。出于隐私保护，提示不会显示原工作区信息。

重新授权后没有增加企业#

如果管理员选择了当前工作区已经连接的企业，YundaDesk 会安全更新并打开原有连接，不会创建重复项。要添加另一家企业，请再次选择“授权新企业”，并由另一家企业的管理员完成授权。

企业解除一直等待删除应用#

确认企业管理员已经在“应用管理 → 第三方应用”中删除 YundaDesk，而不是只解除某个客服帐号的管理权限。删除后返回 YundaDesk，再选择“我已删除，检查状态”。

页面一直显示正在清理#

清理失败时系统会保持全部渠道停用并自动重试，不会提前释放企业连接。稍后刷新页面；如果状态长时间不变，请联系 YundaDesk 支持。

授权后没有帐号#

确认企业微信中已经创建微信客服帐号，然后在 YundaDesk 的渠道导航中展开“微信客服”，选择目标企业，再选择“同步帐号”。若仍为空，检查该企业授权是否有效。

帐号显示无管理权限#

由企业微信管理员把该客服帐号授权给 YundaDesk 应用，再返回同步。若帐号已交给其他第三方应用管理，需先处理原管理关系。

客户消息没有进入工作台#

确认客户使用的是该客服帐号的接入链接或二维码，而不是给普通企微员工发私聊；同时确认对应渠道已经启用。

回复框变为只读#

查看页面给出的原因。常见原因是企业微信原生人工已接手、会话已结束、48 小时窗口过期或 5 条回复额度用尽。

消息先显示已发送，随后失败#

企业微信可能在接受发送请求后异步报告失败。以工作台最终状态和客户微信实际收到为准；按页面提示重新授权、等待客户新消息或重试可重试的消息。