微信开发-- 发送模板消息

Posted 2020-09-25

我们需要将一些行为的进展消息推送给用户。除了短信，发送微信模板消息也是不错的选择。模板消息免费、精准到达、而且可以引导用户回到网站上来。但它有两个前提条件。1个是认证的服务号，你才能选择模板。2个是被推送的用户必须关注了你的公众号，而且你也拿到了他的openid。

先在模板库中找到自己的想要的模板，添加到“我的模板”中。

展开详情，我们可以看到示例。接下来用C#代码发送一次：

从官方文档的示例中我们可以看到除了推送人的openid，还可以设置每个字段的颜色及跳转地址。先可以定义以个TempModel对象：

  public class TemplateModel
    {
        public string touser { get; set; }
        public string template_id { get; set; }
        public string url { get; set; }

        public string topcolor { get; set; }

        public TemplateData data { get; set; } 
    
        public TemplateModel(string hello,string state,string reason,string last)
        {
            data=new TemplateData()
            {
                first = new TempItem(hello),
                keyword1 = new TempItem(state),
                keyword2 = new TempItem(reason),
                remark = new TempItem(last)
            };
             
        }
    }

    public class TemplateData
    {
        public TempItem first { get; set; }
        public TempItem keyword1 { get; set; }
        public TempItem keyword2 { get; set; }
        public TempItem remark { get; set; }
    }
    public class TempItem
    {
        public TempItem(string v,string c = "#173177")
        {
            value = v;
            color = c;
        }
        public string value { get; set; }
        public string color { get; set; }
    }

还有一个返回结果对象：

 public class OpenApiResult
    {
        public int error_code { get; set; }
        public string error_msg { get; set; }

        public string msg_id { get; set; }
    }

然后定义一个发送方法：

using SendHelp= Senparc.Weixin.CommonAPIs.CommonJsonSend;

public OpenApiResult SendTemplateMessage(string token,TemplateModel model)
        {
            var url = string.Format("https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={0}", token);
            try
            {
                var res = SendHelp.Send<OpenApiResult>(token, url, model);
                return res;
            }
            catch (Exception e)
            {
                
                return new OpenApiResult(){error_code = -1,error_msg = e.Message};
            }
          
        } 

SendHelp是基于Senparac.Weixin 最后就可以调用了：

        public ActionResult SendMessage()
        {
            var token = getToken();
            var toUserId = "oBSBmwQjqwjfzQlKsFNjxFLSiIQM";
            var data = new TemplateModel("你好，stoneniqiu","审核通过","资料完整","祝你生活幸福！");
            data.touser = toUserId;
            data.template_id = "gXmkeL7Kc-KUy2EQzKqjPKY-kzFyatTztiYFKCaUPO4";
            data.url = "http://www.xxx.com/xx/xx";
            data.topcolor = "#FF0000";
            var res=wxDeviceService.SendTemplateMessage(token, data);
            return View(res);
        }

token即通过AppID和APPSECRET获取。发送之后，手机上马上收到消息。这里的url就是下图详情的跳转地址。 只能是注册域名下面的地址，不能跳到别的域名去。

但如果你只是拿到了用户的openid，但该用户没有关注公众号，发送时会抛出下面的错误：

其他信息: 微信Post请求发生错误！错误代码：43004，说明：require subscribe hint: [Q2OfvA0092ge21]

相关部分代码：http://files.cnblogs.com/files/stoneniqiu/wx-template.zip

官方文档：https://mp.weixin.qq.com/advanced/tmplmsg?action=faq&token=1798469214&lang=zh_CN

全部错误类型：http://www.szdyhd.com/news/view/webdesign/2016/0614/519.html