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>

渠道是客户联系你的入口。连接后，不同来源的消息会进入同一个工作台，并关联到客户档案。

> 当前接入状态（2026-10-11）：WhatsApp、Messenger、Instagram，以及邮箱选择页的 Outlook 当前显示「渠道维护」，新建入口不可用。Gmail 提供 Google 授权入口；实际接入仍需完成授权及收发验证。下方社交渠道授权说明适用于入口恢复可用或已有渠道支持重新授权时，不能据此判断当前可以新建。

查看可用渠道#

打开“渠道”页面查看当前工作区可以连接的渠道。不同部署、套餐或集成状态下，可用渠道可能不同；页面显示是最终依据。

在目标渠道卡片点击 接入 开始配置。显示 渠道维护 的入口暂时不可接入。

渠道卡片通常会显示连接状态和必要操作。只有完成配置且状态正常的渠道才能稳定收发消息。

在新标签页完成第三方授权#

连接或重新授权 Messenger、Instagram DM、YouTube 时，请保留原“渠道”页面。点击授权按钮后，系统会在新标签页打开第三方登录和同意页；完成或取消后，该标签页会自动关闭，原页面会继续显示账号或频道确认结果，无需手动刷新。

如果没有出现新标签页，请允许当前站点打开弹出式窗口，然后重新点击授权按钮。重新授权时应选择原渠道对应的 Facebook Page、Instagram 专业账号或 YouTube 频道；选择不同资产会失败，并保留原渠道不变。

YouTube 提示授权权限不一致#

看到“YouTube 授权权限不一致”时，本次 YouTube 授权没有保存，当前渠道配置也没有改变。不要反复提交同一次授权；按以下顺序恢复：

1. 先确认 Gmail 或其它已连接的 Google 渠道可以重新授权，并准备好相应账号。
2. 打开 Google 账号的第三方连接设置，找到 YundaDesk，然后移除其旧访问权限。
3. 返回 YundaDesk 的“渠道”页面，重新连接 YouTube，并在同意页核对本次请求的权限。
4. 检查 Gmail 等其它 Google 渠道；如显示授权失效，请使用原账号重新连接并完成收发测试。

移除 YundaDesk 的 Google 访问权限可能同时使已有 Google 渠道需要重新授权。如果你不能确认影响范围，请先联系工作区管理员再操作。

接入邮件渠道#

选择邮件渠道后，先从三种入口中选择：

• Gmail：使用 Google 官方授权连接 Gmail 或 Google Workspace 邮箱。
• Microsoft Outlook：使用 Microsoft 官方授权连接 Outlook 或 Microsoft 365 邮箱。
• 其他邮箱：先填写邮箱地址，再使用页面建议的服务商，或手动填写邮箱服务商提供的收信和发信服务器参数。

连接 Gmail 时，点击 Gmail → 使用 Google 账号登录，在 Google 页面核对账号与申请的邮件权限后授权。返回 YundaDesk 后，确认授权邮箱、发件人名称和邮件同步范围，再点击 连接并启用。只有连接检测成功后才会启用；随后按下文完成收信和回复验证。

如果提示 Google 邮箱授权暂未开放或未配置，请联系工作区管理员；不要反复授权。标记为 渠道维护 的服务商入口暂时不可选，其他可用邮箱入口不受影响。

使用 其他邮箱 时，输入完整邮箱地址后，页面会根据邮箱域名和公开邮件配置建议服务商。建议结果不会自动提交；请确认服务商后再继续。

如果页面无法识别，或建议结果与你实际使用的服务商不一致，请从下方手动选择。使用“其他邮箱”且账号已开启两步验证时，请使用服务商生成的应用专用密码或授权码，不要填写日常登录密码。完成接入后务必运行连接测试，并分别验证收信和发信。

连接渠道后的三个检查#

1. 入站消息：从客户侧发送测试消息，确认工作台能看到。
2. 人工回复：从工作台回复，确认客户侧真实收到，而不只是后台显示成功。
3. AI 接待：如需 AI 回复，进入该渠道的 接待设置，在 接待智能体 中选择负责接待的 Agent，然后从客户侧发起一轮新测试。选择 人工接待 表示该渠道不绑定 Agent。

设置接待方式#

在渠道配置页展开 接待设置，选择 接待智能体。已停用的 Agent 可以保留绑定，但启用后才会自动接待新会话。

在 人工接待 下，用 自动分配 控制是否自动分配给接待成员，并通过 接待成员 选择整个工作区或指定成员。关闭自动分配后，人工会话排队等待成员接入。

接待成员 默认使用 工作区，包含有效的管理员和坐席；只有管理员的工作区也可以使用。也可选择指定成员，此时至少保留一名，不能取消最后一人。若工作区没有有效成员，请先添加或启用成员，再保存接待设置或启用渠道。

自动分配仍要求成员在线、开启接单且未达到接待上限。这个范围也用于 AI 转人工；暂时无人可接待时，会话继续排队。

更改会自动保存，也可以点击 保存；Telegram 和 LINE 渠道需要点击 保存 才会保存。确认页面显示已保存后再离开；若保存失败，保留当前选择并点击 保存 重试。折叠分组时仍可查看当前配置摘要。

若工作区暂时没有有效的管理员或坐席，新创建的渠道会保持停用。添加或启用成员后，进入 接待设置 选择整个工作区或指定成员，保存后再启用。

设置 Widget 外观#

打开网站渠道的配置页，找到 品牌名称；点击 修改品牌 可前往品牌设置。

Free 套餐可以看到悬浮图标选项和 隐藏署名 开关，但暂不可操作，旁边会提示 Starter 套餐解锁。Starter 及以上套餐可选择图标，也可开启开关，隐藏 Widget 首页和会话底部的品牌署名。关闭开关后恢复显示。

更改会自动保存。保存后刷新页面确认设置，并在右侧预览检查效果。旧渠道默认保留署名；降级为 Free 后，署名恢复显示。

渠道与应用的区别#

网站、Telegram、邮件等消息入口属于渠道。店铺、CRM 或其他业务系统通常通过应用或插件连接，为 AI 提供订单、客户或库存能力，但它们本身不一定是消息渠道。

状态异常时#

左侧渠道列表用「异常」标记连接失败的渠道。将鼠标停在标签上可查看完整状态；点击渠道可查看具体原因。

先打开渠道详情查看授权、凭证和连接状态。重新授权后再次做入站和出站测试。后台出现“已接受”并不等于外部平台已经最终送达；需要以客户侧实际收到为准。