文档

应用与集成

连接您的团队已经在使用的工具——Stripe、Shopify、Mailchimp、MailerLite、Jira 和 Tracio。安装后的应用会在收件箱的对话面板中以卡片形式展示实时客户数据,就在聊天旁边。

概览#

应用市场位于 Settings → Apps。应用只需为整个工作区安装一次:由管理员使用工作区自己的凭据连接服务,之后每一位拥有收件箱访问权限的团队成员都会在对话面板中看到相应的卡片。客服人员自己从不安装任何东西——AI 智能体也同样不会安装任何东西。

工作区级安装

每个工作区一套凭据。安装、编辑或移除应用会同时影响所有人。

收件箱中的卡片

每个已安装的应用都会在对话面板中绘制一张卡片,展示与您正在对话的这个人的实时数据。

没有占位内容

目录中列出的每一项今天都可以安装——没有"即将推出"板块。您可以通过请求卡片告诉我们还缺少哪个服务。

管理应用需要 Install and configure apps 权限(默认包含在 Owner 和 Admin 角色中,也可以授予自定义角色)。没有该权限的团队成员仍然可以在对话中看到应用卡片——只是无法安装或重新配置任何东西。

应用目录#

目前有六款应用可用:

应用类别客服在对话中看到什么
Stripe支付与您对话的这个人的订阅和近期付款记录
Shopify电商近期订单及其支付与履约状态
Mailchimp营销与您对话的这个人的订阅状态、受众和标签
MailerLite营销与您对话的这个人的订阅状态、分组和注册日期
Jira问题跟踪与此对话关联的 issue,以及一键创建新 issue
Tracio安全真人还是机器人:Tracio 对聊天挂件访客的判定

只是想要一个指向您自己后台系统的普通链接?那不需要账户也不需要令牌,所以它放在 Settings → General → Links to your systems 中,而不在应用目录里。

安装应用#

打开 Settings → Apps,选择一个卡片,填写该应用要求的凭据。每个字段都会链接到该服务商控制台中创建或查找对应值的确切页面。

步骤说明
1. 查看预览在您粘贴任何内容之前,配置页面会展示客服将会看到的卡片示例——使用虚构数据构建,因此在存储任何凭据之前,您就能知道将与工作区共享什么。
2. 输入凭据粘贴 API 密钥或令牌。值会被自动去除首尾空白——复制粘贴带来的多余空格或换行不会破坏安装。
3. 保存并测试保存会存储配置;测试连接则会向服务商发起一次真实调用,正是它让状态标识变绿。

每个应用卡片都带有一个状态标识,告诉您安装进行到了哪一步:

状态含义
Not tested凭据已存储,但该应用尚未回应过一次真实请求。
Connected服务商已经实际做出了回应——连接是经过验证的,而不只是被保存了。
Needs attention服务商拒绝了存储的凭据(密钥被吊销或已过期)。在管理员重新保存或重新测试该应用之前,卡片会停止调用服务商。
Error其他环节出了问题——请查看提示信息。
Disabled管理员关闭了该应用。卡片从收件箱中消失,但凭据不会被删除。

凭据与安全#

应用凭据属于工作区,几条规则保证它们的安全:

  • 静态加密。密钥类字段(API 密钥、令牌)在存储中逐密钥加密,保存后不会再显示出来。
  • 在服务商允许的范围内最小权限。Stripe 应当使用受限密钥连接——可读取 Customers、Subscriptions、Charges 和 Invoices,只有当客服需要在对话中退款时才加上 Refunds 的写权限。粘贴完全访问权限的密钥也能用,但设置页面会建议您替换它。
  • 更改目标地址会重新要求输入密钥。编辑凭据所绑定的字段——Shopify 店铺域名、Jira 站点 URL——需要重新输入令牌,这样已保存的凭据永远不会被重定向到它不该指向的主机。
  • 吊销影响整个工作区。每个工作区每款应用只有一份安装:如果您在服务商处轮换或吊销了密钥,所有团队成员的卡片都会停止工作,直到管理员在 Settings → Apps 中更新它。

收件箱中的应用卡片#

安装完成后,每款应用都会以小组件的形式出现在收件箱的对话详情面板中。打开一个对话会从服务商拉取一张实时卡片:这位客户在 Stripe 中是谁、他们最近的 Shopify 订单、他们的邮件订阅状态、与该会话关联的 Jira issue,或者 Tracio 对访客的判定。大多数卡片还会链接到服务商自己控制台中的对应记录——Tracio 的判定则完全留在面板内。

卡片在没有内容可展示时会如实说明。如果找不到该客户——或者对话没有可用的身份——卡片会直接说明并解释原因,而不是渲染一个空盒子。响应会被短暂缓存并按应用限制调用频率,因此一个打开的收件箱不会烧光服务商的 API 配额。

卡片跟随已验证身份#

Stripe、Shopify、Mailchimp 和 MailerLite 通过邮箱地址查找客户——并且只使用真正经过验证的地址:由挂件签名身份(身份校验)覆盖的地址,或电子邮件渠道对话的发件人地址。访客只是在聊天中输入的地址完全不会被用于查找——否则任何人都可以输入一位真实客户的邮箱来查看其付款历史。在这种情况下,卡片会解释该地址没有已验证身份作为支撑。

Jira 和 Tracio 不以邮箱为键——Jira 卡片属于对话关联的 issue,Tracio 属于挂件访客——所以即使不存在已验证地址,它们也能工作。

如果用对话本身的地址什么都找不到,Respondo 还会尝试联系人的另一个已知地址(例如联系人合并之后),并在卡片上标注它实际使用的地址。

每个应用显示什么#

Stripe#

客户账单的只读窗口:姓名、邮箱、账户余额和可复制的客户 ID,加上订阅——状态徽标、套餐、月费和开始日期——以及带发票编号的近期付款。退款是唯一可选的写操作:管理员必须在应用设置中打开 Allow refunds from the conversation panel(默认关闭),操作者需要 Run refunds and cancellations 权限,并且每次退款都必须通过输入 REFUND 来确认——退款一旦发出,Stripe 无法撤回。

Shopify#

只读的近期订单——订单号、日期、金额、支付与履约状态——并链接到您 Shopify 管理后台中的每个订单和客户记录。使用您的店铺域名和一个自定义应用的 Admin API 令牌连接,需要 read_customers read_orders 权限范围。

Mailchimp#

以 Mailchimp 的视角呈现订阅者:状态徽标、受众、标签、互动情况和近期营销活动记录(发送、打开、点击)。提供一个操作: Unsubscribe,用于不离开对话就兑现"别再给我发邮件"的请求。它通过 API 无法撤销——Mailchimp 只允许本人通过注册表单重新订阅——因此需要输入文字确认。请注意 Mailchimp API 密钥没有权限范围:您连接的密钥可以读写账户中的一切。

MailerLite#

订阅状态、分组、注册日期、互动情况和近期营销活动记录。两个操作: Unsubscribe(可撤销——MailerLite 的 API 支持重新订阅)和 Resubscribe,用于应本人请求将其重新加回列表。

Jira#

对话与 Jira Cloud issue 之间的双向链接。卡片列出与此对话关联的 issue 及其当前状态,并提供 Create issue(在您选定的项目中创建,自动关联)以及针对已有 issue 的 Link existing / Unlink。在 Jira 中发生的状态变化会通过 webhook 回流:应用的设置页面会显示一个需要粘贴到您 Jira 站点的保密 webhook 地址,此后卡片会实时镜像 issue 的状态。issue 以您连接的 Atlassian 账户身份创建,卡片能看到的正是该账户能看到的内容。

从面板发起的每个操作都受角色权限管控——退订、重新订阅和 Jira issue 需要 Use app actions,退款则需要 Run refunds and cancellations。当某款应用还提供工作区级的能力开关时——目前是 Stripe 的 Allow refunds from the conversation panel——该开关决定这项能力是否存在,关闭它会阻止所有人,包括工作区所有者。

Tracio:真人还是机器人#

Tracio 回答关于聊天挂件访客的一个问题:这是真人还是机器人?安装该应用会在您的 Respondo 聊天挂件中启用 Tracio 的检测 SDK——新的挂件对话会自动获得判定,以标识的形式显示在对话面板的 Tracio 卡片上。

标识含义
HumanTracio 的服务端检查没有发现该访客的机器人信号。
Bot · 93%检测到机器人,并附带 Tracio 的置信度。卡片还会列出支撑该判定的信号。
UncheckedTracio 的服务端检查当前不可用——卡片会回退到浏览器上报的判定并如实说明。
Forged ID浏览器发送的访客 ID 对 Tracio 来说是未知的——该声明看起来是伪造的。

需要连接两把密钥:一把公钥用于在挂件中激活 SDK,一把保密的 Data API 密钥用于对判定做服务端核验。没有服务端核验,浏览器"不是机器人"的声明本身不可信——当浏览器的声明与服务端判定不一致时,卡片会同时展示两者。

Tracio 只适用于聊天挂件对话。电子邮件、Telegram 和其他渠道没有可供检查的访客,因此它们的 Tracio 卡片会解释没有什么可检查的。没有判定并不代表可疑:广告拦截器经常会拦掉真人访客的 SDK,而在 Tracio 连接之前开始的旧对话同样没有判定。
Tracio SDK 会对您站点的访客进行指纹识别。作为站点所有者,(通过您的 CMP / Cookie 横幅)征得访客同意是您的责任。

限制#

  • Stripe 和 Shopify 卡片是只读的——整个 Stripe 应用中唯一的写操作是那个可选的、需显式启用的退款操作。
  • 以邮箱为键的应用(Stripe、Shopify、Mailchimp、MailerLite)需要已验证的邮箱地址。来自匿名挂件访客或没有地址的渠道的对话会显示一张如实的"无可查询内容"卡片。
  • Jira 支持仅覆盖 Jira Cloud。
  • Mailchimp 不提供重新订阅:一旦退订,只有本人可以通过注册表单重新加入。如果这个流程对您重要,请使用 MailerLite 的重新订阅。
  • Tracio 判定只存在于加载了 SDK 的挂件对话中——电子邮件或消息渠道永远不会有。