Livechat配置教程

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

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

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

• 将" Account ID "和" Token" 复制并保存，后续需要配置在" GPTBots - Bot 集成 - 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 - Bot 集成 - Livechat  " 中。

在 GPTBots 配置 Livechat 集成

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

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

• 在 GPTBots 完成 "Livechat 集成" 配置后：

  • AI Bot 将接管 AgentEmail 账号的用户对话，由 AI Bot 直接响应用户的问题。 

  • 根据 AI Bot 的自身能力配置，可支持用户的文字、图片、文件等多模态信息输入。

  • 平台会生成"Webhooks- 消息与事件接收 URL "地址，该地址可用于在 Livechat 后台创建 Webhook 。

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

步骤 1：创建"incoming_chat"事件

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

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

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

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

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

步骤 2：创建"incoming_event"事件

重复创建webhook 的操作步骤，配置"Creating Chat Webhook"以下相关选项后，点击"Save"即可创建成功

• Webhook URL：复用步骤 1 中的"GPTBots Webhook URL"地址填写至输入框。
• Secret Key ：设置时必须使用"步骤 1" 中保存的Secret Key
• Type：选中"License"选项
• Webhook triggers：选择"incoming_event"事件，再勾选"chat_presence_user_ids"

步骤 3：创建"chat_transferred"事件

重复创建webhook 的操作步骤，配置"Creating Chat Webhook"以下相关选项后，点击"Save"即可创建成功

• Webhook URL：复用步骤 1 中的"GPTBots Webhook URL"地址填写至输入框。
• Secret Key ：设置时必须使用"步骤 1" 中保存的 Secret Key
• Type：选中"License"选项
• Webhook triggers：选择"chat_transferred"事件，再勾选"chat_presence_user_ids"

步骤 4：创建"chat_deactivated"事件

重复创建webhook 的操作步骤，配置"Creating Chat Webhook"以下相关选项后，点击"Save"即可创建成功

• Webhook URL：复用步骤 1 中的"GPTBots Webhook URL"地址填写至输入框。
• Secret Key ：设置时必须使用"步骤 1" 中保存的Secret Key
• Type：选中"License"选项
• Webhook triggers：选择"chat_deactivated"事件，再勾选"chat_presence_user_ids"

4 个 Webhook 事件创建成功验证

当显示以上 4 个事件时，代表 4 个 Webhook 事件已全部创建成功。

Install app 并验证

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

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

AI Bot 接管 Agent 客服账号

当用户从 Livechat 平台发起咨询时，将由 AI Bot 提供响应回复。

Livechat 集成高级功能

转移聊天

• 当开启"转移聊天"开关，并配置完成转移聊天的时机和条件后，系统会自动拉取项目在 Livechat 的 Agent 分组名称信息

• 用户在 Livechat 平台发起的咨询符合触发条件时，AI Bot 会根据聊天记录和 Agent 分组名称，选择 1 个最匹配的分组，并将当前用户会话转移至该 Agent 分组（人类客服分组），由该分组下的人类客服账号接管该用户会话。