如何在聊天组件中验证已登录用户

在您的服务器上为已登录用户签名,并将令牌传给 Sell Whisper AI 组件,让智能体知道自己在和谁对话。需 Starter 及以上套餐。

步骤

按顺序完成

  1. 生成身份密钥

    打开智能体,进入“设置”(Settings),再进入“安全”(Security),在“身份验证”(Identity verification)卡片上点击“生成密钥”(Generate secret)。密钥只能保存在您的服务器上。身份验证需 Starter 及以上套餐。

    智能体安全设置
  2. 在您的服务器上为用户签名

    用户登录后,使用该密钥以 HS256 签名,创建一个 JSON Web Token。其中需包含 user_id(或 sub)和过期时间。如果您有用户的邮箱和姓名,也请一并加入;其他任何声明都会作为属性保存到该用户的档案中。

  3. 在页面上调用 identify

    组件加载完成后,传入令牌调用 SellWhisperWidget.identify。用户退出登录时,传入 null 再调用一次,这样下一个使用该浏览器的人会以匿名身份开始。

  4. 检查一段已验证的对话

    在“对话记录”(Chat logs)下打开该用户的一段对话。对话上会带有“已验证”(Verified)标识,并显示用户 ID 和属性;该用户在“用户档案”(Profiles)下也有一条记录。

为什么要验证

没有验证时,组件只知道访客输入了什么。任何人都可以输入别人的邮箱地址。在您的服务器上签名的令牌可以证明:您自己的网站已让此人登录,因此智能体可以把用户 ID 和属性当作事实来对待。

令牌中包含什么

声明是否必填含义
user_id 或 sub是您为该用户分配的固定 ID
exp是过期时间;请设置得短一些,并在页面加载时签发新令牌
email、name否随对话一起显示
其他任何声明否作为属性保存到用户的档案中,例如套餐名称

使用 HS256 和智能体“安全”(Security)设置中的密钥进行签名。如果您无法签发 JSON Web Token,可以传入 user_id 和 user_hash,后者是用同一密钥对用户 ID 生成的 HMAC。

需要遵守的规则

  • 密钥只保存在您的服务器上。 切勿把它放进网站代码、移动应用或公开的代码仓库。如果密钥泄露,请在同一张卡片上轮换它。
  • 按用户、按会话签名。 在为已登录用户渲染页面时创建令牌。
  • 退出登录时清除身份。 调用 identify(null),避免共用的电脑把身份带到下一个人身上。

您会得到什么

  • “对话记录”(Chat logs)中的对话上会带有“已验证”(Verified)标识。
  • “用户档案”(Profiles)下每位用户都有一份档案,其中包含您发送的属性。
  • 可以插入自定义操作的属性,让对您 API 的调用带上已验证的用户 ID。

已验证的用户并不等同于店铺登录:Shopify 和 WooCommerce 操作仍然依靠店铺来确认顾客身份。

用于签名令牌的 Node.js 和 Python 示例,以及页面代码片段,请参阅身份验证。

常见问题

常见问题

已验证的用户等同于店铺登录吗?
不等同。Shopify、WooCommerce 和其他需要登录才能使用的操作,仍会要求店铺验证顾客身份。身份验证告诉智能体的是:您自己的网站认定这位用户是谁。
令牌是伪造的或已过期时会怎样?
令牌会被忽略,对话以匿名身份继续。客户不会看到错误提示。
可以在操作中使用用户的信息吗?
可以。档案属性可以插入自定义操作的请求中,这样对您 API 的调用就能带上已验证用户的 ID 或套餐。

相关文档

开始使用

动手实践这些步骤

免费开始,无需信用卡。