mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-04 12:52:27 +08:00
8ceabc2d0b
* 添加微信客服SDK * polish:优化签名函数 * polish：优化注释内容 * polish:复用已有的Token以及CommonError,移除无用的输出 * polish:复用已有的消息加解密 * fix:修复错误信息被覆盖的问题 * polish:go fmt 文件
88 lines
3.0 KiB
Go
88 lines
3.0 KiB
Go
package kf
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
|
||
"github.com/silenceper/wechat/v2/util"
|
||
)
|
||
|
||
const (
|
||
//获取会话状态
|
||
serviceStateGetAddr = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/get?access_token=%s"
|
||
// 变更会话状态
|
||
serviceStateTransAddr = "https://qyapi.weixin.qq.com/cgi-bin/kf/service_state/trans?access_token=%s"
|
||
)
|
||
|
||
// ServiceStateGetOptions 获取会话状态请求参数
|
||
type ServiceStateGetOptions struct {
|
||
OpenKFID string `json:"open_kfid"` // 客服帐号ID
|
||
ExternalUserID string `json:"external_userid"` // 微信客户的external_userid
|
||
}
|
||
|
||
// ServiceStateGetSchema 获取会话状态响应内容
|
||
type ServiceStateGetSchema struct {
|
||
util.CommonError
|
||
ServiceState int `json:"service_state"` // 当前的会话状态，状态定义参考概述中的表格
|
||
ServiceUserID string `json:"service_userid"` // 接待人员的userid，仅当state=3时有效
|
||
}
|
||
|
||
// ServiceStateGet 获取会话状态
|
||
//0 未处理 新会话接入。可选择：1.直接用API自动回复消息。2.放进待接入池等待接待人员接待。3.指定接待人员进行接待
|
||
//1 由智能助手接待 可使用API回复消息。可选择转入待接入池或者指定接待人员处理。
|
||
//2 待接入池排队中 在待接入池中排队等待接待人员接入。可选择转为指定人员接待
|
||
//3 由人工接待 人工接待中。可选择结束会话
|
||
//4 已结束 会话已经结束。不允许变更会话状态，等待用户重新发起咨询
|
||
func (r *Client) ServiceStateGet(options ServiceStateGetOptions) (info ServiceStateGetSchema, err error) {
|
||
var (
|
||
accessToken string
|
||
data []byte
|
||
)
|
||
accessToken, err = r.ctx.GetAccessToken()
|
||
if err != nil {
|
||
return
|
||
}
|
||
data, err = util.PostJSON(fmt.Sprintf(serviceStateGetAddr, accessToken), options)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if err = json.Unmarshal(data, &info); err != nil {
|
||
return
|
||
}
|
||
if info.ErrCode != 0 {
|
||
return info, NewSDKErr(info.ErrCode, info.ErrMsg)
|
||
}
|
||
return info, nil
|
||
}
|
||
|
||
// ServiceStateTransOptions 变更会话状态请求参数
|
||
type ServiceStateTransOptions struct {
|
||
OpenKFID string `json:"open_kfid"` // 客服帐号ID
|
||
ExternalUserID string `json:"external_userid"` // 微信客户的external_userid
|
||
ServiceState int `json:"service_state"` // 变更的目标状态，状态定义和所允许的变更可参考概述中的流程图和表格
|
||
ServicerUserID string `json:"servicer_userid"` // 接待人员的userid，当state=3时要求必填
|
||
}
|
||
|
||
// ServiceStateTrans 变更会话状态
|
||
func (r *Client) ServiceStateTrans(options ServiceStateTransOptions) (info util.CommonError, err error) {
|
||
var (
|
||
accessToken string
|
||
data []byte
|
||
)
|
||
accessToken, err = r.ctx.GetAccessToken()
|
||
if err != nil {
|
||
return
|
||
}
|
||
data, err = util.PostJSON(fmt.Sprintf(serviceStateTransAddr, accessToken), options)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if err = json.Unmarshal(data, &info); err != nil {
|
||
return
|
||
}
|
||
if info.ErrCode != 0 {
|
||
return info, NewSDKErr(info.ErrCode, info.ErrMsg)
|
||
}
|
||
return info, nil
|
||
}
|