Livechat配置教程

在 Livechat开发者控制台创建 PAT 鉴权

使用计划被 AI Agent 所接管的 LiveChat Agent 账号登录 Livechat开发者控制台，按照以下步骤进行操作：

• 进入 settings 页面选中 Personal Access Tokens，点击"Create new token + "
  

• 创建PAT，access scopes 选择 "select all"
  

• 将" Account ID "和" Token" 复制并保存，后续需要配置在" GPTBots - Agent 集成 - Livechat " 中。
  

在 Livechat  Build app 以用于接收和发送 livechat 平台的消息。

• 进入"Apps"页面，点击" Build app"按钮开始创建 app
  

• 输入 app 名称，Product 选择 livechat 后，点击"Create app"即可创建成功
  

• 点击 app 进入详情页，选择 Blocks页面，点击" Add Building Blocks "按钮
  

• 在" Add Building Blocks "弹窗选中"App Authorization"选项，点击"Add block"
  

• 选择 Server-side app 选项并点击"Save"按钮即可创建成功
  

• 将" Client Id" 和" Client Secret" 复制并保存，后续需要配置在" GPTBots - Agent 集成 - Livechat  " 中。
  

在 GPTBots 配置 Livechat 集成

• 在"GPTBots - 设置 - 集成 - Livechat"页面配置已保存相关信息，点击"提交"按钮即可完成配置。

  • AgentEmail：计划被 AI Agent 接管的 LiveChat Agent 账号邮箱地址，该 Agent 必须是同个项目的人工客服席位的账号
  • Account ID：在 Livechat 创建 PAT 时的 Account ID（被 AI Agent 接管的 LiveChat Agent 账号）
  • Token ：在 Livechat 创建 PAT 时的 Token（被 AI Agent 接管的 LiveChat Agent 账号）
  • Client Id：在 Livechat 创建 app 时的 Client Id
  • Client Secret：在 Livechat 创建 app 时的 Client Secret
  • Secret key：自行输入一个自定义的key并保存好，用于进行 webhook 鉴权。
    

• 在 GPTBots 完成 "Livechat 集成" 配置后，点击保存按钮：

  • AI Agent 将接管 AgentEmail 账号的用户对话，由 AI Agent 直接响应用户的问题。 
  • 根据 AI Agent 的自身能力配置，可支持用户的文字、图片、文件等多模态信息输入。
  • 平台会生成"Webhooks- 消息与事件接收 URL "地址，该地址可用于在 Livechat 后台创建 Webhook 。

配置 Chat webhooks 以实现转移/关闭聊天等高级功能

创建"incoming_event"和"incoming_chat"事件

• 返回 Blocks 页面，点击" Add Building Blocks "按钮创建 webhooks
  

• 在弹窗中选择 "chat webhooks"（注意不是app webhooks）并点击"Add block"选项
  

• 在"GPTBots - 配置 - 集成 - Livechat "的 Webhook 复制 URL 地址
  

• 配置"Creating Chat Webhook"以下相关选项后，点击"Save"即可创建成功

  • Webhook URL：将复制的"GPTBots Webhook URL"地址填写至输入框。
  • Secret key：输入之前保存的自定义的Key
  • Type：选中"License"选项
  • Webhook triggers：选择"incoming_event"和"incoming_chat"事件，再勾选"chat_presence_user_ids"
    
    
    

Install app 并验证

• 进入"Private Installation"页面，点击"Install app"按钮
  

• 最后，进入https://my.livechatinc.com/apps/settings/manage-apps/private 来检查是否安装完毕，如果有 install 标记，那么说明已经安装成功。
  

在 livechat 中配置

选择「Team」-「Group」,创建一个新的群组，在群组中添加被 AI Agent 接管的 LiveChat Agent 账号。添加一个人类客服使用的 Livechat Agent 账号。

• 将被 AI Agent 接管的 LiveChat Agent 账号设置为：Primary agent。
• 将人类客服使用的 Livechat Agent 账号设置为：Backup agent。
  

Livechat 集成高级功能

设置TAG

注：启用该功能后，系统会监听 Livedesk 项目的所有目标事件并设置 TAG,可能会产生大量积分消耗。
当 Livechat 的鉴权配置完成后，可启用「设置TAG」功能。具体配置如下：

• 选择触发场景：系统支持「关闭会话」和「转移聊天」两个事件发生时，触发「设置TAG」操作。
  • 关闭会话：当用户在 Livechat 聊天窗口主动关闭会话时。
  • 转移聊天：当用户在 Livechat 聊天窗口的会话，被转移给另一个客服账号时。
• TAG：系统会自动拉取 Livechat 项目中已设置的 TAG 列表信息
  当选择的触发场景发生时，AI Agent 会根据对话记录选择最匹配的 TAG ，自动调用 「Livechat TAG设置接口」为本次对话设置 TAG 。帮助客服快速定位用户需求，提升客服工作效率。
  

正在回复状态

当 Livechat 的鉴权配置完成后，可启用「正在回复状态」功能。启用该功能后，当用户在 Livechat 聊天窗口发送消息后，将看到「正在回复中的动画效果」，提升用户体验。

Pre-Chat Form

当 Livechat Widget 启用「Pre-Chat Form」功能时，用户在 Livechat 聊天窗口发送消息后，将需要填写「Pre-Chat Form」，实现用户信息的收集。
在 GPTBots - 设置 - 集成 - Livechat 页面配置启用 Pre-Chat Form 功能后，AI Agent 将可接收到用户填写的 Pre-Chat Form 信息。这些信息将被作为对话上下文，帮助 AI Agent 更好地理解用户需求，提供更准确的回复。

设置用户ID

当开发者使用 Livechat 的 Widget 面向网站用户提供服务时，可通过设置用户ID的方式实现 Agent 用户与网站登录用户之间的身份打通。在网站用户处于登录状态时，通过调用 LiveChat Widget SDK 提供的 API 接口设置用户ID,该用户ID将可被GPTBots Agent使用，帮助AI Agent快速定位用户身份，提升服务效率。

                      
                      LiveChatWidget.call("set_session_variables",{user_id: "your_user_id"});