feat: 微信客服支持发送欢迎语

Author: NICEXAI

other.go

@@ -0,0 +1,38 @@
+package WeChatCustomerServiceSDK
+
+import (
+	"encoding/json"
+	"fmt"
+	"github.com/NICEXAI/WeChatCustomerServiceSDK/util"
+)
+
+const (
+	//获取视频号绑定状态
+	corpQualification = "https://qyapi.weixin.qq.com/cgi-bin/kf/get_corp_qualification?access_token=%s"
+)
+
+// CorpQualificationSchema 获取视频号绑定状态响应内容
+type CorpQualificationSchema struct {
+	BaseModel
+	WechatChannelsBinding bool `json:"wechat_channels_binding"` // 	当企业具有绑定成功的视频号时，返回true，否则返回false。 1. 企业申请绑定视频号且由视频号管理员确认后，才为绑定成功状态 2. 至少有一个绑定成功的视频号就会返回true
+}
+
+// GetCorpQualification 获取视频号绑定状态
+// 微信客服可接待的客户数，和企业是否已完成主体验证、是否绑定视频号相关。
+//
+// 企业未完成主体验证时，微信客服仅可累计接待100位客户
+// 企业已验证但未绑定视频号时，微信客服仅可累计接待10000位客户
+// 企业已验证且已绑定视频号时，微信客服可接待的客户数不受限制
+//
+// 开发者可获取状态后，在应用等地方提示企业去完成主体验证或绑定视频号。
+func (r *Client) GetCorpQualification() (info CorpQualificationSchema, err error) {
+	data, err := util.HttpGet(fmt.Sprintf(corpQualification, r.accessToken))
+	if err != nil {
+		return info, err
+	}
+	_ = json.Unmarshal(data, &info)
+	if info.ErrCode != 0 {
+		return info, NewSDKErr(info.ErrCode, info.ErrMsg)
+	}
+	return info, nil
+}

sendmsgonevent.go

@@ -18,9 +18,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) {
 	data, err := util.HttpPost(fmt.Sprintf(sendMsgOnEventAddr, r.accessToken), options)
 	if err != nil {

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"` // 事件消息
 }