微信消息模板

发送模板消息

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

POST数据说明

POST数据示例如下：

{

"touser":"OPENID",

"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",

"url":"http://weixin.qq.com/download",


"miniprogram":{

"appid":"xiaochengxuappid12345",

"pagepath":"index?foo=bar"

},


"data":{

"first": {

"value":"恭喜你购买成功！",

"color":"#173177"

},

"keyword1":{

"value":"巧克力",

"color":"#173177"

},

"keyword2": {

"value":"39.8元",

"color":"#173177"

},

"keyword3": {

"value":"2014年9月22日",

"color":"#173177"

},

"remark":{

"value":"欢迎再次购买！",

"color":"#173177"

}

}

}

参数说明

参数	是否必填	说明
touser	是	接收者openid
template_id	是	模板ID
url	否	模板跳转链接（海外帐号没有跳转能力）
miniprogram	否	跳小程序所需数据，不需跳小程序可不用传该数据
appid	是	所需跳转到的小程序appid（该小程序appid必须与发模板消息的公众号是绑定关联关系，暂不支持小游戏）
pagepath	否	所需跳转到小程序的具体页面路径，支持带参数,（示例index?foo=bar），要求该小程序已发布，暂不支持小游戏
data	是	模板数据
color	否	模板内容字体颜色，不填默认为黑色

注：url和miniprogram都是非必填字段，若都不传则模板无跳转；若都传，会优先跳转至小程序。开发者可根据实际需要选择其中一种跳转方式即可。当用户的微信客户端版本不支持跳小程序时，将会跳转至url。

返回码说明

在调用模板消息接口后，会返回JSON数据包。正常时的返回JSON数据包示例：

 {

"errcode":0,

"errmsg":"ok",

"msgid":200228332

}

使用效果

 

 

 

private SendResultDto SendMessage(ActivityAwardDto activityAward, AwardingRecord awardingRecord, int awardType)
{
SendResultDto sendResult = new SendResultDto
{
errcode = "-1",
errmsg = "发送中奖通知失败",
msgid = string.Empty
};
try
{
MessageTemplateDto messageTemplateDto = new MessageTemplateDto();
MessageData messageData = new MessageData();
messageData.first = new DataValue { value = "恭喜你中奖了", color = "#173177" };
messageData.keyword1 = new DataValue { value = "红牛扫码赢红包活动", color = "#173177" };
messageData.keyword2 = new DataValue { value = awardType == (int)AwardTypeEnum.RedPacket ? "红包" + activityAward.RedPacketPrice + "元" : "优惠券" + activityAward.CouponPrice + "元", color = "#C70000" };
messageData.keyword3 = new DataValue { value = DateTime.Now.ToString("yyyy年MM月dd日 HH:mm"), color = "#173177" };
messageData.remark = new DataValue { value = "点击查看详情。", color = "#173177" };
messageTemplateDto.touser = awardingRecord.WechatUserOpenId;
messageTemplateDto.template_id = "你的模板id";
messageTemplateDto.topcolor = "#000000";
if (awardType == (int)AwardTypeEnum.RedPacket)
{
messageTemplateDto.url = _configuration["AppSetting:GetActivityUrl"] + "UserAward?publicAccountId=" + awardingRecord.PublicAccountId.Value.ToString();
}
if (awardType == (int)AwardTypeEnum.Coupon)
{
messageTemplateDto.miniprogram = new Miniprogram { appid = "你的appid", pagepath = "pages/drawn/index?balance=" + activityAward.CouponPrice.ToString() };
}
messageTemplateDto.data = messageData;
var json = JsonConvert.SerializeObject(messageTemplateDto);
SendMessageTemplateService sendMessageTemplateService = new SendMessageTemplateService(_configuration, HttpContext);
//发送消息模板
sendResult = sendMessageTemplateService.SendMessageTemplate(messageTemplateDto);
SendMessageLog sendMessageLog = new SendMessageLog
{
AwardingRecordId = awardingRecord.Id,
ActivityId = awardingRecord.ActivityId,
WechatUserId = awardingRecord.WechatUserId,
WechatUserName = awardingRecord.WechatUserName,
MessageTitle = "红包中奖通知",
Touser = messageTemplateDto.topcolor,
TemplateId = messageTemplateDto.template_id,
Url = messageTemplateDto.url,
Errcode = sendResult.errcode,
Errmsg = sendResult.errmsg,
Msgid = sendResult.msgid,
CreationTime = DateTime.Now
};
//添加发送日志

_sendMessageLogDomainService.Create(sendMessageLog);
}
catch (Exception ex)
{
Logger.Error("SendMessageForWinning Error", ex);
}
return sendResult;
}
#endregion