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

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

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

一个企业只能连接一个工作区#

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

• 同一工作区可以为同一企业重新授权。
• 如果其他工作区再次为该企业扫码授权，页面只会提示“该企业已连接其他工作区”，不会转移连接，也不会显示原工作区的信息。
• 原工作区必须先完成企业级解除和数据清理，其他工作区才能连接该企业。
• 如果当前工作区已经连接企业 A，必须先解除企业 A，才能连接企业 B。

开始前准备#

你需要：

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

先了解完整流程#

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

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

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

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

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

2. 在 YundaDesk 授权企业#

1. 在 YundaDesk 打开“渠道”。
2. 选择“微信客服”，然后选择“前往企业微信授权”。YundaDesk 会在新页面打开授权，原工作台不会离开当前页面。
3. 使用企业微信管理员完成安装授权，并同意页面列出的企业信息、企业员工信息和微信客服权限。完成后授权页会回到 YundaDesk，原工作台也会自动刷新帐号状态。

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

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

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

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

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

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

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

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

返回 YundaDesk 的微信客服页面，选择“同步帐号”。刚完成企业授权、但尚未分配 API 管理权时，帐号会显示“无管理权限”。

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

启用所选帐号会：

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

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

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 应用，再返回同步。若帐号已交给其他第三方应用管理，需先处理原管理关系。

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

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

回复框变为只读#

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

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

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