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

我们需要将一些行为的进展消息推送给用户。除了短信，发送微信模板消息也是不错的选择。模板消息免费、精准到达、而且可以引导用户回到网站上来。但它有两个前提条件。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