微信公众号配置和使用客服消息

时间:2024-01-30 11:22:57

客服消息简介

当用户和公众号产生特定动作的交互时(具体动作列表请见下方说明),微信将会把消息数据推送给开发者,开发者可以在一段时间内(目前修改为48小时)调用客服接口,通过POST一个JSON数据包来发送消息给普通用户。此接口主要用于客服等有人工消息处理环节的功能,方便开发者为用户提供更加优质的服务。

目前允许的动作列表如下(公众平台会根据运营情况更新该列表,不同动作触发后,允许的客服接口下发消息条数不同,下发条数达到上限后,会遇到错误返回码,具体请见返回码说明页):

1、用户发送信息
2、点击自定义菜单(仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的)
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权
为了帮助公众号使用不同的客服身份服务不同的用户群体,客服接口进行了升级,开发者可以管理客服账号,并设置客服账号的头像和昵称。该能力针对所有拥有客服接口权限的公众号开放。

登录微信公众平台,开通客服功能

开通客服功能后,用户向公众号发送消息时,微信将会把消息数据推送给开发者,这里可以在配置接收的uri地址接口里面拿到消息

在这里拿到消息后,我们需要将某部分消息转发到微信客服系统中

设置消息转发

设置消息转发文档地址
根据文档,将相应消息设置为如下

 string res = @"<xml>
                            <ToUserName><![CDATA[{0}]]></ToUserName>
                            <FromUserName><![CDATA[{1}]]></FromUserName>
                            <CreateTime>{2}</CreateTime>
                            <MsgType><![CDATA[transfer_customer_service]]></MsgType>
                            </xml>";
            return res;

只需要替换里面的ToUserName FromUserName CreateTime即可,这里要注意不能有空格和换行,否则消息转发不成功

添加客服账号

文档地址

/// <summary>
        /// 添加客服账号 
        /// </summary>
        /// <param name="kf_account"></param>
        /// <param name="nickname"></param>
        /// <returns></returns>
        public string AddInviteworker(string kf_account, string nickname)
        {
            string token = GetWxToken();
            string url = "https://api.weixin.qq.com/customservice/kfaccount/add?access_token=" + token;
            using (WebClient webClient = new WebClient())
            {
                webClient.Encoding = Encoding.UTF8;
                webClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
                string sResponse = webClient.UploadString(url, "POST", JsonConvert.SerializeObject(new
                {
                    kf_account,
                    nickname
                }));
                var res1 = JsonConvert.DeserializeObject<dynamic>(sResponse);
                LogHelper.Error(res1);
                return sResponse;
            }
        }

添加成功后邀请绑定微信用户成功客服

 /// <summary>
        /// 邀请绑定客服帐号
        /// </summary>
        /// <param name="kf_account">完整客服帐号,格式为:帐号前缀@公众号微信号</param>
        /// <param name="invite_wx">接收绑定邀请的客服微信号</param>
        /// <returns></returns>
        public string BindInviteworker(string kf_account,string invite_wx) {
            string token = GetWxToken();
            string url = "https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=" + token;
            using (WebClient webClient = new WebClient())
            {
                webClient.Encoding = Encoding.UTF8;
                webClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
                string sResponse = webClient.UploadString(url, "POST", JsonConvert.SerializeObject(new {
                    kf_account,
                    invite_wx
                })) ;
                var res1 = JsonConvert.DeserializeObject<dynamic>(sResponse);
                Console.WriteLine(sResponse);
                return sResponse;
            }
        }

发送消息,可以通过接口调用发送消息,也可以登录微信公众平台客服网页版直接发送消息

   /// <summary>
        /// 发送客户消息
        /// </summary>
        /// <param name="touser"></param>
        /// <param name="content"></param>
        /// <returns></returns>
        public  string SendMsgWechat(string touser,string content) {

            string token = GetWxToken();
            string url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token="+ token;
            using (WebClient webClient = new WebClient())
            {
                webClient.Encoding = Encoding.UTF8;
                webClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
                string sResponse = webClient.UploadString(url, "POST", JsonConvert.SerializeObject(new {
                    touser,
                    msgtype= "text",
                    text = new {
                        content= content
                    }
                }));
                var res1 = JsonConvert.DeserializeObject<dynamic>(sResponse);
                LogHelper.Error(res1);
                return sResponse;
            }

        }

直接在微信客服网页版发送消息