人工服务-Webhook
最新更新:2024-07-23
人工服务-Webhook
GPTBots 当前人工服务已支持Intercom
,LiveChat
和Webhook
三个产品或服务,当开发者选择 webhook 作为人工服务接入方式时,首先需要在自己的服务器环境构建一个 Webhook 服务,提供以下3个接口用于接收 Agent 发起的人工服务初始化请求和接收用户消息。
创建会话ID
用于为 Agent 用户创建一个人工客服对话ID
请求方式
POST
调用地址
https://your_domain/conversation/establish
请求参数
参数 | 类型 | 说明 |
---|---|---|
conversation_id | string | 会话id,在客服回复接口需要透传给 GPTBots |
timestamp | long | 时间戳 |
string | 用户邮箱,部分人工服务系统必须提供邮箱方可正常提供服务 | |
bot_id | string | Agent(原 bot)的id |
body | list<Object> | 消息体 |
body.message_type | string | 消息类型,QUESTION/ANSWER |
body.text | string | 客户发起人工客服的问题以及上下文 |
user_info | object | 用户信息 |
user_info.phone | string | 用户的手机号码,目前只在whatsapp转人工客服的时候有值 |
- 通过 iframe/Share/Bubble Widget 方式发起人工服务时,用户必须填写用户邮箱.也同时允许开发者自定义用户邮箱从而避免用户填写邮箱。
- 通过 WhatsApp/Telegram/livechat 等三方平台请求人工服务时,默认使用 support@gptbots.ai作为用户邮箱,其中livechat支持开发者自定义用户邮箱。
- 通过 API 请求人工服务时,允许 email 字段为空,为空时默认使用 support@gptbots.ai 作为用户邮箱。
响应
参数 | 类型 | 说明 |
---|---|---|
code | int | 响应码 |
message | string | 详情 |
聊天接口
Agent 用户向人工客服发送消息
请求方式
POST
调用地址
请求参数
参数 | 类型 | 说明 |
---|---|---|
conversation_id | string | 对话ID,在客服回复接口需要透传给 GPTBots |
timestamp | long | 时间戳 |
body | string | 客户的问题 |
响应
参数 | 类型 | 说明 |
---|---|---|
code | int | 响应码 |
message | string | 详情 |
关闭会话接口
用户对话超时或者 Agent 用户主动关闭对话时触发
请求方式
POST
调用地址
https://your_domain/conversation/close
请求参数
参数 | 类型 | 说明 |
---|---|---|
conversation_id | string | 对话ID,在客服回复接口需要透传给 GPTBots |
timestamp | long | 时间戳 |
type | string | 关闭的类型、TIMEOUT(超时关闭)/ USER_CLOSED(用户主动关闭) |
响应
参数 | 类型 | 说明 |
---|---|---|
code | int | 响应码, |
message | string | 详情 |
GPTBots 人工客服接口
开发者选择 webhook 作为人工服务接入方式时,GPTBots 提供的用于接收开发者发送的人工客服回复消息和对话控制指令的 API 接口
接收客服消息
用于接收开发者端人工客服的回复消息,并消息内容将展示在Bot对话窗口。
请求方式
POST
调用地址
https://api.gptbots.ai/v1/human/message/receive
请求参数
参数 | 类型 | 说明 | required |
---|---|---|---|
conversation_id | string | 对话ID,在对话创建接口和聊天接口有传,透传即可 | true |
timestamp | long | 时间戳 | true |
body | string | 人工客服的回复内容 | true |
响应
参数 | 类型 | 说明 |
---|---|---|
code | int | 响应码, |
message | string | 详情 |
人工客服关闭会话
人工客服在需要时可以选择主动关闭对话,关闭后用户将不能再接收到客服的消息,除非用户重新发起人工客服对话。
请求方式
POST
调用地址
https://api.gptbots.ai/v1/human/close
请求参数
参数 | 类型 | 说明 |
---|---|---|
conversation_id | string | 对话 ID,在客服回复接口需要透传给 GPTBots |
timestamp | long | 时间戳 |
响应
参数 | 类型 | 说明 | required |
---|---|---|---|
conversation_id | string | 对话ID,在会话创建接口和聊天接口有传,透传即可 | true |
timestamp | long | 时间戳 | trueß |