千家信息网

如何使用.net开发微信公众号中的模板消息

发表于:2025-02-01 作者:千家信息网编辑
千家信息网最后更新 2025年02月01日,这篇文章将为大家详细讲解有关如何使用.net开发微信公众号中的模板消息,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。微信公众号中的模板消息1 TemplateMes
千家信息网最后更新 2025年02月01日如何使用.net开发微信公众号中的模板消息

这篇文章将为大家详细讲解有关如何使用.net开发微信公众号中的模板消息,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。

微信公众号中的模板消息

1 TemplateMessage类简介
TemplateMessage静态类封装了跟模板消息相关的方法,见下表:

方法名功能
SetIndustry设置行业
GetId获取模板id
Send发送模板消息

2 设置所属行业

TemplateMessage类的SetIndustry方法用于设置公众号所属的行业,该方法的定义如下:

        ///         /// 设置行业        ///         /// 公众号        /// 行业代码1        /// 行业代码2        /// 返回设置是否成功        public static ErrorMessage SetIndustry(string userName, string code1, string code2)        //或者        ///         /// 设置行业        ///         /// 公众号        /// 行业1        /// 行业2        /// 返回设置是否成功        public static ErrorMessage SetIndustry(string userName, Industry industry1, Industry industry2)

其中,Industry为行业类,类中的静态成员包含了已知的所有行业,例如:Industry.OnlineGame代表了网络游戏这一行业;Industry类有三个属性,分别为:Code--行业代码,Name--行业名称,PrimaryIndustry--主行业。

设置所属行业的示例:

///     /// 设置所属行业    ///     ///     ///     protected void btnSetIndustry_Click(object sender, EventArgs e)    {        string userName = lbPublicAccount.SelectedValue;        string industryCode1 = "", industryCode2 = "";        int count = 0;        foreach (ListItem item in cblIndustry.Items)        {            if (item.Selected)            {                count++;                if (count == 1)                    industryCode1 = item.Value;                else if (count == 2)                {                    industryCode2 = item.Value;                    break;                }            }        }        if (count != 2)            ltrMessage.Text = "请选择两个行业。";        else        {            ErrorMessage errorMessage = TemplateMessage.SetIndustry(userName, industryCode1, industryCode2);            ltrMessage.Text = string.Format("设置所属行业{0}。{1}",                errorMessage.IsSuccess ? "成功" : "失败",                errorMessage.IsSuccess ? "" : errorMessage.ToString());        }    }设置所属行业示例

设置所属行业示例

3 获得模板id

TemplateMessage类的GetId方法用于获取模板id,该方法定义如下:

        ///         /// 获取模板ID        ///         /// 公众号        /// 模板库中模板的编号,有"TM**"和"OPENTMTM**"等形式        /// 返回获取是否成功        /// 返回模板ID;如果获取失败,返回空字符串。        public static string GetId(string userName, string shortTemplateId, out ErrorMessage errorMessage)

注意:(1)如果尚未添加模板,该方法会先添加模板,然后返回模板id;(2)如果已经添加了模板,再次调用该方法,会返回一个新的不同于上次获取到的模板id。

获得模板id的示例:

    ///     /// 添加并模板id    ///     ///     ///     protected void btnGetTemplateId_Click(object sender, EventArgs e)    {        string userName = lbPublicAccount.SelectedValue;        ErrorMessage errorMessage;        string templateId = TemplateMessage.GetId(userName, txtTemplateIdShort.Text, out errorMessage);        if (errorMessage.IsSuccess)            ltrMessage.Text = string.Format("添加并获取模板id成功。模板id:{0}", templateId);        else            ltrMessage.Text = string.Format("添加并获取模板id失败。{0}", errorMessage.ToString());    }

获得模板id示例

4 发送模板消息
TemplateMessage类的Send方法用于发送模板消息,该方法定义如下:

        ///         /// 发送模板消息        ///         /// 公众号        /// 接收消息的账号        /// 模板id        /// 详情地址        /// 顶端颜色        /// 数据        /// 返回发送是否成功        /// 返回消息id;如果发送失败,返回-1。        public static long Send(string userName, string touser, string templateId, string detailUrl, Color topColor,            Tuple[] data, out ErrorMessage errorMessage)

其中,data参数为Tuple类型,包含模板所用的数据,data.Item1为数据键,data.Item2为数据值,data.Item3为显示数据的颜色。

发送模板消息的示例:

///         /// 发送模板消息        ///         /// 公众号        /// 接收消息的账号        /// 模板id        /// 详情地址        /// 顶端颜色        /// 数据        /// 返回发送是否成功        /// 返回消息id;如果发送失败,返回-1。        public static long Send(string userName, string touser, string templateId, string detailUrl, Color topColor,            Tuple[] data, out ErrorMessage errorMessage)

发送模板消息示例

5 接收推送模板消息发送结果事件
在发送模板消息之后,微信服务器会推送结果到公众号的指定URL上,公众号服务器会接收到一条RequestTemplateSendJobFinishMessage类型的请求消息。
RequestTemplateSendJobFinishMessage类有以下只读属性:

///         /// 获取消息id        ///         public long MsgID { get; private set; }        ///         /// 获取群发消息的结果        ///         public string Status { get; private set; }        ///         /// 获取消息是否群发成功        ///         public TemplateMessageSendStatusEnum SendStatus        {            get            {                TemplateMessageSendStatusEnum status;                if (Status == sendFailedUserBlock)                    status = TemplateMessageSendStatusEnum.UserBlock;                else if (Status == sendFailedSystemFailed)                    status = TemplateMessageSendStatusEnum.SystemFailed;                else                    status = TemplateMessageSendStatusEnum.Success;                return status;            }        }

关于"如何使用.net开发微信公众号中的模板消息"这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,使各位可以学到更多知识,如果觉得文章不错,请把它分享出去让更多的人看到。

0