微信小程序开发实战8_1 小程序客服消息的接收

为丰富小程序的服务能力，提高服务质量，微信为小程序提供客服消息的功能。小程序用户可以使用客服消息与小程序服务提供方进行沟通。
客服消息会话入口

小程序内：开发者在小程序内添加客服消息按钮组件，用户可在小程序内唤起客服会话页面，给小程序发消息；
已使用过的小程序客服消息的用户会在微信中看到一个微信会话：“小程序客服消息”，进入“小程序客服消息”会话可查看历史客服消息，以及发送客服消息。

客服消息类型

目前支持文本及图片类型消息

客服消息的接收

若小程序没有启用消息推送，则用户发送的消息将会被转发至网页版和移动端小程序客服工具，客服人员可在网页版与移动端小程序客服工具中接入并回复用户。
如小程序启用了消息推送，则所有的客服消息将推送到开发者填写的URL对应的服务器，不再推送到网页版客服工具和移动端小程序客服工具。

发送客服消息

小程序可通过以下两种方式下发客服消息：

调用发送客服消息接口下发客服消息。
使用公众平台网页版客服工具下发客服消息。

下发条件说明

当用户和小程序客服产生特定动作（如用户向小程序客服发送消息、或者进入会话等情况）的交互时，微信将会把消息数据推送给开发者，开发者可以在一段时间内（目前为 48 小时）调用客服接口，给用户发送客服消息。

8.1消息推送的设置

登录小程序管理后台后，在【开发管理】->【开发设置】->【消息推送】中，管理员扫码启用消息服务，填写服务器地址（URL）、令牌（Token）和消息加密密钥（EncodingAESKey）等信息。

URL: 开发者用来接收微信消息和事件的服务器URL地址。开发者所填写的URL 必须以 http:// 或 https:// 开头，分别支持 80 端口和 443 端口。
Token: 可由开发者可以任意填写，用于生成签名（该Token会和接口 URL中包含的Token进行比对，从而验证安全性）。
EncodingAESKey: 由开发者手动填写或随机生成，将用作消息体加解密密钥。

开发者提交信息后，微信服务器将给填写的服务器URL地址发送GET请求，GET请求携带参数如下所示：
signature：微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
timestamp：时间戳
nonce：随机数
echostr：随机字符串
开发者通过 signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。加密/校验逻辑如下：
将token、timestamp、nonce三个参数进行字典序排序
将三个参数字符串拼接成一个字符串进行sha1加密
开发者把加密后的字符串与signature对比，验证该请求是否来源于微信
验证URL有效性成功后即接入生效，成为开发者。消息推送参数验证的相关代码如下所示：

func str2sha1(data string)string{t:=sha1.New()io.WriteString(t,data)return fmt.Sprintf("%x",t.Sum(nil))
}
//验证消息推送参数
func HandlerWxSignCheck(w http.ResponseWriter, r *http.Request) {signature := r.FormValue("signature")timestamp := r.FormValue("timestamp")nonce := r.FormValue("nonce")echostr := r.FormValue("echostr")var token string="demo_token"tmps:=[]string{token,timestamp,nonce}sort.Strings(tmps)tmpStr:=tmps[0]+tmps[1]+tmps[2]tmp:=str2sha1(tmpStr)if signature != tmp {echostr = ""}w.Write([]byte(echostr))
}

8.2接收客服消息

当某些特定的用户操作（如用户向小程序客服发送消息、或者进入会话等情况）引发事件推送时，微信服务器会将消息（或事件）的数据包以POST请求发送到开发者配置的URL，开发者可以依据自身业务逻辑进行响应。
微信服务器在将用户的消息发给开发者服务器地址后，微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。服务器收到请求后必须做出下述回复，这样微信服务器才不会发起重试，否则，将出现严重的错误提示。详见下面说明：

直接回复success（推荐方式）
直接回复空串（指字节长度为0的空字符串，而不是结构体中content字段的内容为空）
对于客服消息，一旦遇到以下情况，微信会在小程序会话中向用户下发系统提示“该小程序客服暂时无法提供服务，请稍后再试”：
开发者在5秒内未回复任何内容
开发者回复了异常数据

文本消息的结构

用户在客服会话中发送文本消息时将产生如下数据包：

{"ToUserName": "toUser","FromUserName": "fromUser","CreateTime": 1482048670,"MsgType": "text","Content": "this is a test","MsgId": 1234567890123456
}

参数说明

ToUserName:小程序的原始ID
FromUserName:发送者的openid
Content:文本消息内容

图片消息的结构

用户在客服会话中发送图片消息时将产生如下数据包：

{"ToUserName": "toUser","FromUserName": "fromUser","CreateTime": 1482048670,"MsgType": "image","PicUrl": "this is a url","MediaId": "media_id","MsgId": 1234567890123456
}

参数说明

ToUserName：小程序的原始ID
FromUserName：发送者的openid
MsgType：image
PicUrl：图片链接（由系统生成）
MediaId：图片消息媒体id，可以调用【获取临时素材】((getTempMedia)接口拉取数据。
接收客服消息的示例代码：

//微信用户消息
type WxMsgRecive struct {ToUserName        string    `json:"ToUserName"`FromUserName   string    `json:"FromUserName"`CreateTime        int64     `json:"CreateTime"`MsgType       string    `json:"MsgType"`MsgId        int64     `json:"MsgId"`Content       string    `json:"Content"`PicUrl           string    `json:"PicUrl"`MediaId       string    `json:"MediaId"`
}
//接收微信发送的消息
func HandlerReciveWxMsg(w http.ResponseWriter, r *http.Request) {bdata, _ := ioutil.ReadAll(r.Body)var ent wxpay.WxMsgReciveerr := json.Unmarshal(bdata, &ent)if err != nil {fmt.Println(err)}//接受到消息后的业务流程//.......w.Write([]byte("success"))
}

说明:

上述代码只能用于明文消息的接收，若消息推送培配置中将消息设置为安全模式，则需要对发送的数据进行解密。
由于接收前不能获取消息的类型，因此需要定义一个包含所有字段的结构来解析消息数据：WxMsgRecive。