特性
解决方案
文档
博客
公司
GPTBots 文档 > 使用教程 > 集成 > Livechat
GPTBots 文档 > 使用教程 > 集成 > Livechat
Livechat配置教程
最新更新：2024-10-08

Livechat配置教程

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

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

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

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

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

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

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

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

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

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

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

在 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 必须是同个项目的人工客服席位的账号 livechat 集成配置

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

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

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

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

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

步骤 1：创建"incoming_chat"事件

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

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

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

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

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

步骤 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" Webhook triggers

步骤 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" Webhook triggers

步骤 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" Webhook triggers

4 个 Webhook 事件创建成功验证

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

Install app 并验证

AI Bot 接管 Agent 客服账号

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

Livechat 集成高级功能

转移聊天

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

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