新建并配置 Agent
选择 Role,并配置 Agent 的知识范围、工具与操作、技能、接待设置和接待渠道。
更新于 2026-08-30
嵌入聊天气泡,主题可白标
通过 API 对接自有系统收发消息
把客户邮件汇成工单,统一回复
连接 WhatsApp 商业号接待客户
连接 Facebook 主页,接待私信
接收并回复 Instagram 私信
连接 LINE 官方账号接待客户
连接 Telegram 机器人,自动收发客户消息
接入申请中,以 TikTok 平台审核与授权结果为准
连接 Zalo 官方账号接待客户
评论接收与回复
接入企业官方微信客服帐号
客户联系、群聊与坐席协作
使用 Facebook 安全授权
无需复制 App Secret、校验令牌或主页令牌;YundaDesk 会自动列出可管理主页并检查连接。
由我授权
当前成员是 Facebook 主页管理员。
使用 Facebook 连接选择要接入的 Facebook 主页
授权会在新标签页完成;标签页随后自动关闭,结果回到当前工作台。
系统会订阅 messages、postbacks、delivery 和 read 事件,并立即检查真实连接。
完成接入选择你的邮箱服务商
连接已有邮箱;Gmail 和 Outlook 使用官方授权,其他邮箱使用密码或应用专用密码。
输入邮箱地址
我们会根据邮箱后缀预填常见服务商的收发信设置;无法识别时仍可手动填写。
未匹配到预设,下一步可手动填写收发信设置。
高级设置
imap.yourbrand.com · 993smtp.yourbrand.com · 465先以禁用状态保存,再实测 IMAP 与 SMTP;两项通过后才启用渠道。
连接并启用选择要接入的客服帐号
每个所选帐号会成为立即启用的独立渠道,AI 回复默认关闭。
仅应用于当前 Website Widget 渠道。渠道名称和主题色也属于当前渠道。
标题、描述和欢迎语只需填写一种语言,系统会根据访客语言自动翻译并复用翻译结果。
复制下面的代码并粘贴到你的网站中,即可加载聊天气泡。
复制后放到网站、Bot 资料或对接文档中。
复制<script src="https://cdn.yundadesk.com/widget.js" data-yd-key="yd_widget_main" async></script>- Widget Key
- yd_widget_main
- 脚本地址
- https://cdn.yundadesk.com/widget.js
- 直达链接
- https://cdn.yundadesk.com/?widget_key=yd_widget_main
Telegram Bot 配置指南
只需三步:① 找 @BotFather 创建 Bot 拿 Token → ② 左侧粘贴 Token → ③ 保存并启用,系统自动接收新消息。
1. 创建 Telegram Bot
- 在 Telegram 中搜索 @BotFather 并打开对话。
- 发送 /newbot 创建新 Bot。
- 按提示填入显示名 + 用户名(以 _bot 结尾)。
- 复制 BotFather 返回的 Bot Token 备用。
2. 在左侧填入 Token 并启用
- 把 Token 粘贴到左侧「Bot Token」。
- 点击顶部的「保存」→ 再点「启用」。
- 点击「测试连接」验证 Bot Token 是否有效。
3. 测试 Bot
- 在 Telegram 搜索 Bot 用户名并开始对话。
- 发送任意消息,AI / 坐席将自动回复。
- 参考 Telegram Bot API 文档。
Telegram Bot Token 无效,请检查。
连接失败Telegram Bot 配置指南
只需三步:① 找 @BotFather 创建 Bot 拿 Token → ② 左侧粘贴 Token → ③ 保存并启用,系统自动接收新消息。
1. 创建 Telegram Bot
- 在 Telegram 中搜索 @BotFather 并打开对话。
- 发送 /newbot 创建新 Bot。
- 按提示填入显示名 + 用户名(以 _bot 结尾)。
- 复制 BotFather 返回的 Bot Token 备用。
2. 在左侧填入 Token 并启用
- 把 Token 粘贴到左侧「Bot Token」。
- 点击顶部的「保存」→ 再点「启用」。
- 点击「测试连接」验证 Bot Token 是否有效。
3. 测试 Bot
回调会经 YundaDesk 固定安全出口发送。如接收端限制来源,请将出口 IP 加入白名单。
回调会经 YundaDesk 固定安全出口发送。请将以下 IP 加入白名单:203.0.113.10, 203.0.113.11
查看白名单 IPCustom API 接入指南
1. 创建 Custom API 渠道
- 左侧填写渠道名与「你的系统回调 URL」。
- 保存后系统会生成接入 Key 与签名密钥,用于确认消息归属和请求真实性。
- (可选)填写 IP 白名单,限制来源。
2. 转发客户消息到 YundaDesk
- 把消息以 JSON 格式 POST 到上方 Webhook URL。
- 请求头带上接入 Key、时间戳、签名和幂等键。
- 返回 200 表示已接收;其它状态视为失败,系统会重试。
3. 接收回复推送
- 启用后 YundaDesk 把坐席 / AI 回复推送到左侧填写的「你的系统回调 URL」。
- 请按外部消息 ID 做幂等去重。
| 事件 | 时间 | 状态 |
|---|---|---|
| message.created | 2026/07/28 14:20 | 已送达 |
| message.created | 2026/07/28 14:06 | 连接超时 · 重试中 |
| conversation.assigned | 2026/07/28 13:41 | 签名失败 |
安装一个 YundaDesk 插件,为 WordPress 站点启用在线客服、AI 客服和安全的 Widget 绑定。
复用同一个 YundaDesk WordPress 插件;检测并只读授权 WooCommerce 后,同步店铺、客户、订单、商品和当前购物车上下文。
连接 BigCommerce 店铺,同步客户订单上下文,并在工作台侧栏展示最近订单。
确认后,此 WordPress 站点将绑定到当前工作区,并返回站点后台完成 PKCE 交换。
- 站点
- https://wp-review.yundadesk.com
- 工作区
- YundaDesk Review
- 版本
- YundaDesk 1.0.0 · WordPress 7.0.2
- WooCommerce
- 已检测到 10.9.4,连接站点后仍需单独授予只读权限
此次确认只建立站点绑定和公开 Widget 配置,不会读取 WooCommerce 店铺数据。WooCommerce 只读授权必须稍后在 WordPress 后台单独确认。
| 客户 | 联系方式 | 渠道 / 来源 | 来源地 | 最近互动 |
|---|---|---|---|---|
| MMaria Garcia | Web Widget | 05/18 | ||
| LLukas Schneider | Telegram+49 30 123456 | 05/20 | ||
| AAna Silva | 05/22 |
确认 AI 是否可以放心接待、靠什么回答、哪里需要你处理。
3 个触达任务待处理
按订单号查物流。
最近 3 次真实命中:Web Widget · Custom API 外部送达 1 次,待验证 2 次,失败 0 次。| 分类 | 能力 | 状态 | 当前情况 | 接入方式 |
|---|---|---|---|---|
| 主动触达能力 | 群发通知AI 可以为一组客户生成群发通知草稿,默认需要确认后发送。 | 只能生成草稿 | 缺少批量投递工具,不能直接向所有客户群发。 | 接入批量投递工具;未接入前只允许生成待确认草稿。 |
| 主动触达能力 | 单个客户私聊AI 可以给一个明确客户生成并发送一条受控消息。 | 暂未开放 | 当前套餐未开启这项能力。 | 该能力暂未开放,无需现在配置。 |
| 主动触达能力 | 按人群触达AI 可以先筛选目标客户,再生成面向该人群的触达草稿。 | 待接入 | 缺少客户分群搜索工具,无法定位目标客户群体。 | 接入客户分群搜索工具后即可使用。 |
| 客户数据能力 | 读取客户资料AI 可以读取当前客户的基础资料与会话上下文。 | 可用 | AI 可以读取当前客户的基础资料与会话上下文。 | Yuna 可以在学习、回答和触达判断中使用这项能力。 |
↳Yes, Brazil shipping usually takes 7-12 business days.
人工答的·1↳自动识别 VIP 客户 · 识别 VIP 身份并提示坐席优先跟进。
人工答的·1·L2 风险↳Opened items can be returned within 30 days if the package is complete.
人工答的·1↳DHL 超过 72 小时未更新时,先查订单,再转人工确认补偿。
你纠正过·1·L2 风险| 技能 | 状态 | 应用场景 | 近 7 天 | 操作 |
|---|---|---|---|---|
| 订单物流查询客户问订单到哪了时,先查询订单,再用品牌话术回复。 | 启用中 | 查询处理 | 使用 12 次成功率 92% | › |
| 自动识别 VIP 客户识别 VIP 身份并提示坐席优先跟进。 | 测试中 | 问题分流 | 尚未使用 | › |
客户问订单到哪了时,先查询订单,再用品牌话术回复。
选择客户场景,使用生产执行器进行无真实副作用的模拟。
模拟不会发送客户消息或执行真实外部操作。
只显示客户接待中的真实技能调用,不包含场景模拟。
| 维度 | 会话量 | 消息量 | 平均首响 | 解决数 | 占比 |
|---|---|---|---|---|---|
| Web Widget | 712 | 4,128 | 38s | 496 | 60% |
| Telegram | 284 | 1,620 | 45s | 219 | 24% |
| 198 | 980 | 3m 12s | 146 | 17% |
个人与项目
坐席身份
基础信息
项目身份
团队成员
| 成员 | 角色 | 状态与技能 | 最后登录 | 最后使用 | 操作 |
|---|---|---|---|---|---|
| ACAnna Chen我anna@yundadesk.test在线 | 管理员 | 已激活英语退款最大并发 12 | 今天 09:42 | 2 分钟前 | |
| LWLeo Wangleo@yundadesk.test在线 | 坐席 | 已激活英语售后最大并发 6 | 昨天 18:20 | 今天 10:06 | |
| MGMaria Garciamaria@yundadesk.test离线 | 坐席 | 邀请中西语售前最大并发 8 | — | — |
消息通知
通知权限
通知设置
通知场景
测试通知
发送测试发送一条测试通知以验证功能是否正常。
发送键
会话输入框的发送键偏好,按坐席独立保存。
主动触达
保存触达策略
防打扰与置信度
人工评审
订阅与用量
升级套餐购买 AI Credit购买记录联系运营用量配额
权益门禁
写操作会按工作区状态、功能开关与额度用量判断是否放行。
无法建立安全连接;若网站只提供 HTTP,请使用 http:// 地址重新抓取
| 文档 | 大小 | 标签 | 更新时间 | 状态 | 操作 |
|---|---|---|---|---|---|
| 客服知识 · Notion · 128 篇来源文件夹 · 展开查看同步文档 | — | — | 最近同步 2026/07/29 03:10 | 已可检索 | ⋯ |
| Brazil shipping timelines已编译 12 条问答 | — | 最近更新 2026/06/03 16:00 | 已可检索 | ⋯ | |
| EU customs & duties | — | 最近更新 2026/06/04 14:30 | 正在索引 | ⋯ | |
| 30-day refund policy已编译 9 条问答 | — | 最近更新 2026/06/02 20:00 | 已可检索 | ⋯ |
| 文档 | 大小 | 标签 | 更新时间 | 状态 | 操作 |
|---|---|---|---|---|---|
| Brazil shipping policy | — | 最近更新 2026/06/03 16:05 | 等待索引 | ⋯ | |
| EU customs & duties | — | 最近更新 2026/06/04 14:30 | 正在索引 | ⋯ | |
| Brazil shipping timelines | — | 最近更新 2026/06/03 16:00 | 已可检索 | ⋯ | |
| Import restrictions PDF错误:PDF 文件没有可读取文字 | — | 最近更新 2026/06/07 16:30 | 索引失败 | ⋯ |
| 文档 | 大小 | 标签 | 更新时间 | 状态 | 操作 |
|---|---|---|---|---|---|
| tgo.ai · 0 篇已处理 3 / 已发现 50 页 | — | — | 抓取任务运行中 | 抓取中 | ⋯ |
| tgo.ai · 47 篇上次同步成功 · 共 47 页 | — | — | 最近同步 2026/06/20 16:00 | 已可检索 | ⋯ |
| 客户问题 | 标准回答 | 来源 | 标签 | 状态 | 操作 |
|---|---|---|---|---|---|
| Do you ship to Brazil? | Shipping to Brazil usually takes 7-12 business days. | 编译生成 · Brazil shipping policy | 已启用 | ⋯ |
连接 Notion 后,选择要同步的页面并自动导入文档。
连接 Notion尚未连接 Notion
人工确认加购挽回 准备触达客户,请确认触达链路。
人工确认新增 FAQ:包裹发出后可在订单页查看物流轨迹。
客户问了商品材质问题,需要你确认是否写入学习库。
Telegram 回复没有成功送达,需要处理渠道发送。
一次 AI 接待运行失败,可以查看回答链路。
今天有什么需要我处理的?
有 3 件事:2 条学习建议待确认、1 个主动触达待你确认。昨天 AI 自动解决率 84%,比上周高 3 个点。
决定由内置 AI 还是外接 AI 处理自动回复。
访客和坐席都会看到这个名字
选中的渠道由当前 AI 自动接待;没选中的渠道不会走 AI 回复开关。
选择选择负责所有已绑定渠道自动回复的 AI 服务。
Maya 售前顾问
这是同一个默认 AI 客服的名称,访客和坐席都会看到;切换内置或外接来源不会创建第二个 AI。
AI 接待来源
内置和外接只能二选一;选中的来源会处理下方已接管渠道的 AI 自动回复。
使用 YundaDesk 内置成长链路,支持 YundaDesk AI学习、技能生成和评审。
外接 AI 只处理自动回复,不参与 YundaDesk AI的学习和技能生成。
「AI 服务」点「更换」二选一:内置 AI 带学习和技能;外接 AI 只生成回复。
从主导航打开 AI Agents,按业务职责管理客户接待 Agent。一个 Agent 选择一个 Role,可以接待多个渠道;一个渠道同一时间只绑定一个 Agent。
新建 Agent#
- 打开 AI Agents,选择 新建 Agent。
- 从页面提供的 Role 中选择最符合接待目标的一项。
- 输入便于团队识别的 Agent 名称并确认创建。
- 创建完成后进入该 Agent 的详情页继续设置。
新 Agent 默认不会接待客户,也不会自动占用现有渠道。Role 只确定接待目标,不会自动添加知识或开放能力。
完成设置#
按详情页分区检查:
- 角色与行为:确认名称、Role、服务风格、补充要求、语气和回复方式;需要创建或调整服务风格时,点击 与 Yuna 创建/调整;
- 知识范围:选择该 Agent 回答时可以使用的文件、文件夹、Notion 内容或网站;
- 工具与操作:开启该 Agent 确实需要的查询或操作工具;
- 技能:启用或停用已经属于该 Agent 的客户接待技能;需要重复运行主动触达时,前往 Yuna → 自动化;
- 接待设置:设置答不上、敏感请求和其他需要人工处理的边界;
- 接待渠道:选择由该 Agent 接待的渠道;
- 运行记录:查看该 Agent 最近的测试或接待记录,并打开回答详情检查依据。
如果所选渠道已经绑定其他 Agent,页面会提示转移。确认后,新客户会话使用新绑定;已经进行中的会话继续由原 Agent 处理。
服务风格用于保持同一个 Agent 稳定的自我描述、性格和表达习惯。Agent 页面只展示当前摘要;点击 与 Yuna 创建/调整 后,Yuna 会在当前页面以悬浮对话打开,不会中断正在查看的配置。Yuna 会读取当前服务风格,一次询问一个必要问题,了解你希望客户获得的感受、说话习惯和需要避免的表达。信息足够且要求明确后,Yuna 会直接保存并在对话中告诉你结果,不再显示额外确认卡。
Role 或技能发生切换时,服务风格仍保持不变,因此客户感受到的是同一个客服继续处理不同问题。服务风格只改变“怎么说”,不会增加知识、开放工具、绕过审批或改变业务政策;示例也不能代替知识库中的事实。建议描述可观察的行为,例如“客户着急时先给明确结论”,不要根据一次对话写永久人格判断。
也可以打开 渠道,进入某个渠道的 接待设置,在 接待 Agent 中直接选择负责该渠道的 Agent;选择 人工接待 会解除 Agent 绑定。这里与 Agent 详情的 接待渠道 是同一项设置,从任一处修改都会同步到另一处。选择已停用 Agent 会保留绑定,但要启用该 Agent 后才会自动接待新会话。
选择器按“文件与文件夹、Notion 与连接、网站”分区。文件夹下保留子文件层级,可以选择单个文件或整个文件夹;网站按整站选择,不提供抓取页面的单页勾选。选择文件夹、Notion 或网站后,后续同步到该范围的新内容也会自动纳入。保存前必须明确选择至少一项,系统不会自动扩大到整个知识库。
已经连接的应用或插件工具会与内置工具一起显示。尚未连接的扩展不会出现在 Agent 表单中;需要扩展时,按页面提示前往应用中心安装或连接。开启工具不会绕过成员权限。退款、取消订单、发送消息等会改变外部状态的操作,在真正执行前仍可能要求有权限的成员确认,避免误操作、资金损失或错误触达客户。
运行记录可以帮助团队复盘回答、发现知识缺口并决定后续跟进或学习建议;查看运行记录本身不会自动发送客户消息,也不会自动修改知识库或技能。
启用与验证#
- 在 AI Agents 页面右上角选择 测试对话,再选择要测试的 Agent;
- 检查回复是否使用了正确知识和工具;
- 检查答不上、敏感请求和转人工场景;
- 在 接待渠道 中至少绑定一个已连接渠道,再从停用提示或页头的 更多 Agent 操作 选择 启用 Agent;
- 优先使用 Web Widget 完成一轮真实入站和回复验证。
Agent 已启用但没有绑定渠道时仍不会接待客户,列表会显示为草稿。配置成功也不等于客户侧已经收到回复,最终应以客户界面可见的消息为准。
停用、归档或删除#
Agent 的角色、知识范围、工具和接待设置属于配置;是否运行属于独立状态。保存配置不会自动启用或停用 Agent。
需要停止这个 Agent 时,在详情页打开 更多 Agent 操作,选择 停用 Agent,阅读影响后确认。停用不会解除已绑定渠道或删除配置,但这个 Agent 不再自动回复新消息,也不会发起新的主动触达;当前由 AI 接待的会话会回到待接待队列,人工仍可继续处理。页面会显示 Agent 已停用,之后可从提示或同一菜单选择 启用 Agent。重新启用只影响之后符合条件的新任务,不会自动领回已经转为待接待或人工接待的会话。
归档和删除也位于 更多 Agent 操作。操作前先确认渠道和进行中的会话将如何处理。工作区必须保留至少一个 Agent,因此最后一个 Agent 不能归档或删除。
排错#
- 无法创建:刷新 Role 列表后重试;没有可选 Role 时联系管理员或 YundaDesk 支持。
- 没有自动回复:确认 Agent 已启用、渠道已连接且明确绑定到该 Agent。
- 知识、工具或技能没有生效:回到对应分区检查是否已选择并保存,再重新测试。
- 渠道无法选择:它可能已绑定其他 Agent;查看转移提示并确认目标。