From 3fb288d9323c5a86f35003daf79e83b9f5538d70 Mon Sep 17 00:00:00 2001 From: Afeyer <1500527791@qq.com> Date: Fri, 8 Oct 2021 19:37:40 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=BE=AE=E4=BF=A1=E5=AE=A2=E6=9C=8D?= =?UTF-8?q?=E6=94=AF=E6=8C=81=E5=8F=91=E9=80=81=E6=AC=A2=E8=BF=8E=E8=AF=AD?= =?UTF-8?q?=20(#496)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- work/kf/sendmsgonevent.go | 13 ++++++++++++- work/kf/syncmsg/message.go | 1 + 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/work/kf/sendmsgonevent.go b/work/kf/sendmsgonevent.go index 8060d3a..17396df 100644 --- a/work/kf/sendmsgonevent.go +++ b/work/kf/sendmsgonevent.go @@ -19,9 +19,20 @@ type SendMsgOnEventSchema struct { } // SendMsgOnEvent 发送事件响应消息 +// 当特定的事件回调消息包含code字段，或通过接口变更到特定的会话状态，会返回code字段。 +// 开发者可以此code为凭证，调用该接口给用户发送相应事件场景下的消息，如客服欢迎语、客服提示语和会话结束语等。 +// 除”用户进入会话事件”以外，响应消息仅支持会话处于获取该code的会话状态时发送，如将会话转入待接入池时获得的code仅能在会话状态为”待接入池排队中“时发送。 +// +// 目前支持的事件场景和相关约束如下： +// +// 事件场景 允许下发条数 code有效期 支持的消息类型 获取code途径 +// 用户进入会话，用于发送客服欢迎语 1条 20秒 文本、菜单 事件回调 +// 进入接待池，用于发送排队提示语等 1条 48小时 文本 转接会话接口 +// 从接待池接入会话，用于发送非工作时间的提示语或超时未回复的提示语等 1条 48小时 文本 事件回调、转接会话接口 +// 结束会话，用于发送结束会话提示语或满意度评价等 1条 20秒 文本、菜单 事件回调、转接会话接口 +// //「进入会话事件」响应消息： // 如果满足通过API下发欢迎语条件（条件为：1. 企业没有在管理端配置了原生欢迎语；2. 用户在过去48小时里未收过欢迎语，且未向该用户发过消息），则用户进入会话事件会额外返回一个welcome_code，开发者以此为凭据调用接口（填到该接口code参数），即可向客户发送客服欢迎语。 -// 为了保证用户体验以及避免滥用，开发者仅可在收到相关事件后20秒内调用，且只可调用一次。 func (r *Client) SendMsgOnEvent(options interface{}) (info SendMsgOnEventSchema, err error) { var ( accessToken string diff --git a/work/kf/syncmsg/message.go b/work/kf/syncmsg/message.go index d889903..a447b78 100644 --- a/work/kf/syncmsg/message.go +++ b/work/kf/syncmsg/message.go @@ -159,5 +159,6 @@ type SessionStatusChangeEvent struct { ChangeType uint32 `json:"change_type"` // 变更类型。1-从接待池接入会话 2-转接会话 3-结束会话 OldReceptionistUserID string `json:"old_servicer_userid"` // 老的客服人员userid。仅change_type为2和3有值 NewReceptionistUserID string `json:"new_servicer_userid"` // 新的客服人员userid。仅change_type为1和2有值 + MsgCode string `json:"msg_code"` // 用于发送事件响应消息的code，仅change_type为1和3时，会返回该字段。可用该msg_code调用发送事件响应消息接口给客户发送回复语或结束语。 } `json:"event"` // 事件消息 }