mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-09 07:02:27 +08:00
91 lines
3.8 KiB
Go
91 lines
3.8 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 已结束 会话已经结束或未开始。不允许变更会话状态，客户重新发信咨询后会话状态变为“未处理”
|
||
// 注：一个微信用户向一个客服帐号发起咨询后，在 48h 内，或主动结束会话前（包括接待人员手动结束，或企业通过 API 结束会话），都算是一次会话
|
||
func (r *Client) ServiceStateGet(options ServiceStateGetOptions) (info ServiceStateGetSchema, err error) {
|
||
var (
|
||
accessToken string
|
||
data []byte
|
||
)
|
||
if accessToken, err = r.ctx.GetAccessToken(); err != nil {
|
||
return
|
||
}
|
||
if data, err = util.PostJSON(fmt.Sprintf(serviceStateGetAddr, accessToken), options); 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 时要求必填，接待人员须处于“正在接待”中
|
||
}
|
||
|
||
// ServiceStateTransSchema 变更会话状态响应内容
|
||
type ServiceStateTransSchema struct {
|
||
util.CommonError
|
||
MsgCode string `json:"msg_code"` // 用于发送响应事件消息的 code，将会话初次变更为 service_state 为 2 和 3 时，返回回复语 code，service_state 为 4 时，返回结束语 code。可用该 code 调用发送事件响应消息接口给客户发送事件响应消息
|
||
}
|
||
|
||
// ServiceStateTrans 变更会话状态
|
||
func (r *Client) ServiceStateTrans(options ServiceStateTransOptions) (info ServiceStateTransSchema, err error) {
|
||
var (
|
||
accessToken string
|
||
data []byte
|
||
)
|
||
if accessToken, err = r.ctx.GetAccessToken(); err != nil {
|
||
return
|
||
}
|
||
if data, err = util.PostJSON(fmt.Sprintf(serviceStateTransAddr, accessToken), options); 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
|
||
}
|