【微信開發】-- 發送模板消息

我們需要將一些行為的進展消息推送給用戶。除了短信，發送微信模板消息也是不錯的選擇。模板消息免費、精准到達、而且可以引導用戶回到網站上來。但它有兩個前提條件。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