C#服务号推送微信公众号模板消息

已于 2023-04-06 15:41:09 修改
阅读量4k 收藏 20
点赞数 1
分类专栏： .NET 文章标签： 微信 微信公众平台 Powered by 金山文档
于 2023-02-20 18:04:29 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ohdajing/article/details/129128826
版权

一、准备工作

微信公众平台：https://mp.weixin.qq.com/

申请测试账号：https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index

鉴于一些兄弟需要jsonhelper，特放百度网盘，需要自取

链接：https://pan.baidu.com/s/1fceTTPQUqiYHL6QU7s1row

提取码：gv4v

微信推送消息模板不需要发布服务器，也不需要填写授权回调域名，只需要两个微信后台的参数

在公众号后台设置与开发——>基本配置中获取AppID、AppSecret

二、实现思路

我的需求是给特定分组的用户推送模板消息，分为以下4步

  1. 获取access_token（把token存缓存，不用每次请求）

  1. 获取公众号的所有标签，得到目标分组

  1. 获取指定标签下的粉丝列表，得到用户的openid

  1. 给粉丝推送模板消息

三、后端代码

1.获取AccessToken

/// <summary>
/// Access_token 的摘要说明
/// </summary>
public class Access_token
{
    public string access_token{ get;set; }
    public int expires_in { get; set; } //凭证有效时间
    public string errcode { get; set; } //返回码
    public string errmsg { get; set; } //返回说明
    public DateTime CreateTime { get; set; }
}

//token缓存键值对
private static Dictionary<string, Access_token> tokenCache = new Dictionary<string, Access_token>();
//获取access_toke
    /// <summary>
    /// 获取缓存令牌
    /// </summary>
    public static string GetAccessToken(string appid, string secret)
    {
        //token缓存
        Access_token result = null;
        //判断缓存是否存在键：appid，就将缓存中的token赋给result
        if (tokenCache.ContainsKey(appid))
        {
            result = tokenCache[appid];
        }
        //不存在则获取token
        if (result == null)
        {
            result = GetToken(appid, secret);
            result.CreateTime = DateTime.Now;
            tokenCache.Add(appid, result);
        }
        //判断是否在有效期内，过期重新获取token    给10s延迟时间
        else if (System.DateTime.Compare(result.CreateTime.AddSeconds(result.expires_in), System.DateTime.Now) < 7200)
        {
            result = GetToken(appid, secret);
            result.CreateTime = DateTime.Now;
            tokenCache[appid] = result;
        }
        return result.access_token;
    }
  /// <summary>
    /// 获取AccessToken
    /// </summary>
    /// <returns></returns>
    public static Access_token GetToken(string appid, string secret)
    {
        string grant_type = "client_credential";
        string tokenUrl = string.Format("https://api.weixin.qq.com/cgi-bin/token?grant_type={0}&appid={1}&secret={2}", grant_type, appid, secret);
        var wc = new WebClient();
        var strReturn = wc.DownloadString(tokenUrl);
        //得到token
        Access_token tokeninfo = JsonHelper.ToJson<Access_token>(strReturn);
        return tokeninfo;
    }

2.得到所有标签

 static JavaScriptSerializer jszer = new JavaScriptSerializer();

    /// <summary>
    /// 得到所有标签
    /// </summary>
    /// <param name="accesstoken"></param>
    /// <returns></returns>
    public static int GetTagList(string accesstoken)
    {
        int pagecode=0;
        //得到所有标签
        string tagUrl = string.Format("https://api.weixin.qq.com/cgi-bin/tags/get?access_token={0}", accesstoken);
        var wc = new WebClient();

        wc.Encoding = System.Text.Encoding.UTF8;
        var strReturn = wc.DownloadString(tagUrl);
        Root list = jszer.Deserialize<Root>(strReturn);
        //循环遍历所有标签，如果是移动时则赋值pagecode，循环停止
        if (list != null)
        {
            foreach (var item in list.tags)
            {
                if (item.name == "移动")
                {
                    pagecode = item.id;
                    break;
                }
            }
            return pagecode;
        }
        else
        {
            return pagecode;
        }
    }
public class Tags    
{
    /// <summary>
    /// 
    /// </summary>
    public int id { get; set; }
    /// <summary>
    /// 星标组
    /// </summary>
    public string name { get; set; }
    /// <summary>
    /// 
    /// </summary>
    public int count { get; set; }
}

public class Root
{
    /// <summary>
    /// 
    /// </summary>
    public List<Tags> tags { get; set; }
}

3.获取标签下粉丝列表，得到用户的openid

   /// <summary>
    /// 获取标签下粉丝列表
    /// </summary>
    /// <returns></returns>
    public static List<string> GetTagUserList(string token)
    {
        List<string> list = new List<string>();
        int tagecode = GetTagList(token);   
        string tokenUrl = string.Format("https://api.weixin.qq.com/cgi-bin/user/tag/get?access_token={0}", token);
        PostTage strpost = new PostTage();
        strpost.tagid = tagecode;
        strpost.next_openid = "";
        HttpWebRequest hwr = WebRequest.Create(tokenUrl) as HttpWebRequest;
        hwr.Method = "POST";
        hwr.ContentType = "application/x-www-form-urlencoded";
        byte[] payload;
        payload = System.Text.Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(strpost)); //通过UTF-8编码
        hwr.ContentLength = payload.Length;
        Stream writer = hwr.GetRequestStream();
        writer.Write(payload, 0, payload.Length);
        writer.Close();
        var result = hwr.GetResponse() as HttpWebResponse; //此句是获得上面URl返回的数据
        var responseReader = new StreamReader(result.GetResponseStream());
        TagUserList codestate = JsonHelper.ToJson<TagUserList>(responseReader.ReadToEnd());
        if (codestate != null && codestate.data != null)
        {
            list.AddRange(codestate.data.openid);
        }
        return list;
    }
public class PostTage
{
    //最后一个用户的openid 
    public int tagid { get; set; }
    //第一个拉取的OPENID，不填默认从头开始拉取 
    public string next_openid { get; set; }
}

public class Data
{
    /// <summary>
    /// 
    /// </summary>
    public List<string> openid { get; set; }
}

public class TagUserList
{
    /// <summary>
    /// 
    /// </summary>
    public int count { get; set; }
    /// <summary>
    /// 
    /// </summary>
    public Data data { get; set; }
    /// <summary>
    /// 
    /// </summary>
    public string next_openid { get; set; }
}

4.给用户推送模板消息

   /// <summary>
    /// 公众号发送推送消息
    /// </summary>
    public async Task<bool> SendMessage(string strtoken, List<string> oplist) //string strtoken)
    {


        bool istrue = false;
        //根据access_token构建推送接口
        string sendUrl = $@"https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={strtoken}";
        System.Net.Http.HttpClient sendclient = new System.Net.Http.HttpClient();
        MessageTemplateSendDto mts = new MessageTemplateSendDto();
        mts.template_id = ConfigurationManager.AppSettings["template_id"];
        //创建list 循环这里
        //必填 接收者openid
        foreach (var item in oplist)
        {
            mts.touser = item;
            //构建请求数据对象
            //必填 模板数据
            mts.data = new MessageTemplateSendDataDto
            {
                first = new MessageTemplateSendDataContentDto()
                {
                    value = "工作任务提示消息",
                    color = "#173177"
                },
                keyword1 = new MessageTemplateSendDataContentDto()
                {
                    value = "通知消息",
                    color = "#173177"
                },
                keyword2 = new MessageTemplateSendDataContentDto()
                {
                    value = "张三",
                    color = "#173177"
                },
                keyword3 = new MessageTemplateSendDataContentDto()
                {
                    value = "截止:02月14日，XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                    color = "#173177"
                },
                keyword4 = new MessageTemplateSendDataContentDto()
                {
                    value = DateTime.Now.ToShortDateString(),
                    color = "#173177"
                },
                remark = new MessageTemplateSendDataContentDto()
                {
                    value = "请及时查看",
                    color = "#173177"
                }
            };
            try
            {
                HttpWebRequest hwr = WebRequest.Create(sendUrl) as HttpWebRequest;
                hwr.Method = "POST";
                hwr.ContentType = "application/x-www-form-urlencoded";
                byte[] payload;
                payload = System.Text.Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(mts)); //通过UTF-8编码
                hwr.ContentLength = payload.Length;
                Stream writer = hwr.GetRequestStream();
                writer.Write(payload, 0, payload.Length);
                writer.Close();
                var result = hwr.GetResponse() as HttpWebResponse; //此句是获得上面URl返回的数据
                var responseReader = new StreamReader(result.GetResponseStream());
                WxOpenidCodeState codestate = JsonHelper.ToJson<WxOpenidCodeState>(responseReader.ReadToEnd());

                if (codestate.errcode == "0")
                {
                    istrue = true;
                }

            }
            catch (Exception e)
            {

                var t = e.Message;
                istrue = false;
            }
        }
        return istrue;
    }

public class MessageTemplateSendDto
{

    /// <summary>
    /// 必填
    /// 接收者openid
    /// </summary>
    public string touser { get; set; }

    /// <summary>
    /// 必填
    /// 模板ID
    /// </summary>
    public string template_id { get; set; }

    /// <summary>
    /// 必填
    /// 模板数据
    /// </summary>
    public MessageTemplateSendDataDto data { get; set; }

    /// <summary>
    /// 模板内容字体颜色，不填默认为黑色
    /// </summary>
    public string color { get; set; }

    /// <summary>
    /// 防重入id。对于同一个openid + client_msg_id, 只发送一条消息,10分钟有效,超过10分钟不保证效果。若无防重入需求，可不填
    /// </summary>
    public string client_msg_id { get; set; }

}

public class MessageTemplateSendDataDto
{
    public MessageTemplateSendDataContentDto first { get; set; }
    public MessageTemplateSendDataContentDto keyword1 { get; set; }
    public MessageTemplateSendDataContentDto keyword2 { get; set; }
    public MessageTemplateSendDataContentDto keyword3 { get; set; }
    public MessageTemplateSendDataContentDto keyword4 { get; set; }
    public MessageTemplateSendDataContentDto remark { get; set; }
}
public class MessageTemplateSendDataContentDto
{
    /// <summary>
    /// 文本内容
    /// </summary>
    public string value { get; set; }

    /// <summary>
    /// 文本颜色
    /// </summary>
    public string color { get; set; }
}
public class WxOpenidCodeState
{
 
    //返回code
    public string errcode { get; set; }

    // 返回消息
    public string errmsg { get; set; }
}

5.调用方法

        //获取access_token
        string strtoken = WXApi.GetAccessToken(appid, secret);
        //获取关注用户列表
        List<string> oplist = WXApi.GetTagUserList(strtoken);
        //发送模板消息
        Task<bool> istrue = SendMessage(strtoken, oplist);

6.配置文件

AppID和AppSecret及模板ID为了安全尽量别写在页面上，建议写在配置文件再在页面调用

配置文件

<appSettings>
    <!--微信的Token-->
    <add key="WeixinToken" value="weiphp" />
    <!--开发者ID(AppID)-->
    <add key="AppId" value="wxe9XXXXXXXXXX" />
    <!--开发者密匙-->
    <add key="AppSecret" value="804XXXXXXXXXXXXXXXXXXXXX" />
      <!--模板ID--> 
    <add key="template_id" value="0hXXXXXXXXXXXXXXXX" />
  </appSettings>

页面

    //公众号的appid|secret
    static string appid = ConfigurationManager.AppSettings["AppId"];
    static string secret = ConfigurationManager.AppSettings["AppSecret"];

一开始纠结了好久推送图文模板消息，研究了下发现

1.微信只提供发送文字模板功能，未提供推送图文的接口，图文消息只能通过后台的群发功能，但是一个月只能发4次。

2.开通高级群发功能，一个月可以有400次推送机会，但单个用户也只能接收4次。

3.可以通过第三方平台可以实现每天的服务号群发功能，但第三方平台服务内容包含无限次推送微信模版消息和群发图文给48小时内互动关注过的用户。

有推送图文需求的小伙伴的话，两个笨办法勉强能实现

  1. 开发完推送模板消息接口后，url再加个图片链接,用户应该可以点击模版消息跳转图片。

  1. 编辑完群发图文后存为草稿 ，然后输入用户的微信ID给用户发测试图文 （适合用户不多的情况）

值得注意的是：微信推送消息模板的ID来自于微信后台设置的所在行业，选择不同的行业属性会相应提供对应的消息模板，调用推送消息接口的时候去后台找到相应的模板ID即可。

再再一次值得注意的是：申请的测试号调试推送时，代码里的自定义模板消息不生效，切到正式环境就好啦。

余予渔与鱼腴
关注
专栏目录
C#推送微信公众号模版消息
LYfrighting的博客
08-23 4032
1. 需要在微信公众号申请模版消息，选择你的行业范围 2.【模版消息】—— 【模版库】     可以搜索你想要的模版，也可以申请需要的模版。 3. 点击详情：添加到我的模板 4. 我的模板 ：复制模板ID   5.  C#后台代码推送消息 public static string send_equipment(string openid, string name) ...
C#微信公众号自动回复源码
LLl的博客
06-05 1288
/// <summary> /// WechartInterface 的摘要说明 /// </summary> public class WechartInterface : IHttpHandler { protected string TOKEN = "cct001"; //TOKEN 必须跟你在微信公众平台上写的token是一致的 protected string StationId = ...
C#实现微信推送公众号文章
10-29
C#微信公众号开发之上传永久素材，找到代码自己写的功能实现，学习用，有问题可以反馈，不一定太好，参考就好
C#开发微信公众平台-就这么简单（附Demo）
weixin_34202952的博客
03-27 571
写在前面 　　阅读目录： 服务号和订阅号 URL配置 创建菜单 查询、删除菜单 接受消息 发送消息（图文、菜单事件响应） 示例Demo下载 后记 　　最近公司在做微信开发，其实就是接口开发，网上找了很多资料，当然园友也写了很多教程，但都是理论说了一大堆，实用指导或代码很少。如果你自己仔细研究下，其实就那么点东西，C#实现起来也很简单，原本不想写这篇文章的，但是本人当时摸...
微信公众号开发----推送模板消息（第⑥篇）
最新发布
m0_64315223的博客
09-30 1938
模板推送那肯定是少不了数据的，我们创建一个json并且引入到推送代码中。最后消息也是推送成功了，如果有问题评论区留言~电影地区:{{address.DATA}}电影主角:{{person.DATA}}电影价格:{{price.DATA}}电影名称:{{name.DATA}}首先需要拿到token和openid。格式： {{sxxx.DATA}}
C#微信接口之推送模板消息功能示例
08-30
主要介绍了C#微信接口之推送模板消息功能,结合实例形式分析了C#操作微信推送模板消息接口的具体操作步骤与相关使用技巧,需要的朋友可以参考下
Asp.net core(c#)实现在微信公众号定时推送模板消息（包括获取access_token、openid与unionid）
nfkjdx的博客
12-20 3512
至此，在微信公众号上进行模板添加的步骤已经完成，大家可以参考，详细添加可以看看官方介绍。到这里全部介绍完毕，大家可以参考一下！//设置时间间隔为1分钟执行代码。
C# 微信服务号推送模板消息
zhaoguanghe的博客
08-01 3088
这两天一直在做微信服务号模板消息推送，以下代码出自https://www.jb51.net/article/118132.htm 这里是封装的调用模板函数，放在项目中直接调用即可。 public string SendTempletMessge() {    string strReturn = string.Empty;    try    {      #region 获取acc...
C#微信开发之发送模板消息
08-30
主要为大家详细介绍了C#微信开发之发送模板消息的相关资料，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
微信公众平台对接C#-微信模版消息发送
lianjiangwuzhong的专栏
08-02 298
#region 模版消息发送 /// <summary> /// 发送公众号客服通知 /// </summary> /// <param name="wxopenid"></param> /// <param name="first"></param> /// <param name="keyword1"></param.
springboot实现微信公众号模版消息推送
07-09
springboot实现微信公众号模版消息推送，用的是构架：springboot+redis,详细教程：https://blog.csdn.net/chenhongming888/article/details/95173079
asp.net 微信模板发送
11-09
研究了半个月，终于把微信模板消息研究出来了。新手不易，以此纪念
微信公众平台消息接口c#版
12-13
微信只有php版，自己改写的微信公众平台消息接口c#版
c#版的微信开发接收和发送消息示例
05-26
微信的官方文档，接收和发送消息处理示例
.net微信公众号参数二维码模板消息
05-13
1、服务器和微信的链接 2、图文回复消息 3、创建删除菜单 4、获取用户openid信息 5、客服发送消息 6、模板发送消息 7、参数二维码生成 8、扫描参数二维码接收参数和用户openid PS:代码仅供参考，需要在服务号上配置和获取 token，AppID，AppSecret，access_token以及设置网页OAuth2.0鉴权的网页地址。 全程几乎无验证，最好不要直接使用，建议完善验证安全机制。 其中1-4在上一个资源里发过了。5-8是新加的功能，而且增加了token防止反复调用超过2000次限制。存入xml里。如果新人看不懂，建议只下载1-4的。代码没有使用WeiXinMPSDK中的任何接口，仅仅是根据微信开发文档资料编写的。
asp.net 实现微信公众平台的主动推送信息源码
12-31
微信公众帐号主动发送消息给用户，asp.net版本
微信公众号--根据用户的opneId发送模版消息
qq_45278588的博客
08-12 974
微信公众号--根据用户的opneId发送模版消息
微信公众号消息增加跳转链接
热门推荐
徐二七的博客
11-28 3万+
微信公众号消息增加跳转链接 背景： 用户在首次关注公众号后会弹出一条欢迎消息。给这条消息增加跳转的链接，使得用户在点击之后可以跳转 到一个你希望用户访问的页面。 解决方案： 根据微信开发者文档，找到了3种实现方式。 1.文本消息 文本消息提供的参数中是不存在url这个参数的。所以无法使用官方提供的接口直接添加跳转链接。只能退而 求其次，在文本内容中裸写跳转url。例如：''欢迎关注
c#发送微信模板消息
wangdao1212的专栏
01-02 5419
直接上代码，微信模板消息api在 微信公众号中，https://developers.weixin.qq.com/miniprogram/dev/api/，如下图 C#代码如下：  string revMsg = "\"data\":{\"keyword1\":{\"value\":\"" + shenQingRoleName + "\",\"color\":\&qu
评论 9
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值