本⽂介绍中的模板消息,包括以下内容:(1)TemplateMessage类简介;(2)设置所属⾏业;(3)获得模板id;(4)发送模板消息;(5)接收推送模板消息发送结果事件。
本⽂演⽰地址:
本⽂源代码地址:
一起呼叫 没有烦恼1 TemplateMessage类简介
TemplateMessage静态类封装了跟模板消息相关的⽅法,见下表:
⽅法名功能
SetIndustry设置⾏业
GetId获取模板id
Send发送模板消息
2 设置所属⾏业
TemplateMessage类的SetIndustry⽅法⽤于设置所属的⾏业,该⽅法的定义如下:
/// <summary>
///设置⾏业
/// </summary>
/// <param name="userName"></param>
/// <param name="code1">⾏业代码1</param>
/// <param name="code2">⾏业代码2</param>
/// <returns>返回设置是否成功</returns>
public static ErrorMessage SetIndustry(string userName, string code1, string code2)
//或者
/// <summary>
/
//设置⾏业
/// </summary>
/// <param name="userName"></param>
/// <param name="industry1">⾏业1</param>
/// <param name="industry2">⾏业2</param>
/// <returns>返回设置是否成功</returns>
public static ErrorMessage SetIndustry(string userName, Industry industry1, Industry industry2)
其中,Industry为⾏业类,类中的静态成员包含了已知的所有⾏业,例如:Industry.OnlineGame代表了⽹络游戏这⼀⾏业;Industry类有三个属性,分别为:Code——⾏业代码,Name——⾏业名称,PrimaryIndustry——主⾏业。
设置所属⾏业的⽰例:
/// <summary>
///设置所属⾏业
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
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,该⽅法定义如下:
/// <summary>
///获取模板ID
/// </summary>
/// <param name="userName"></param>
/// <param name="shortTemplateId">模板库中模板的编号,有“TM**”和“OPENTMTM**”等形式</param>
/// <param name="errorMessage">返回获取是否成功</param>
/// <returns>返回模板ID;如果获取失败,返回空字符串。</returns>
public static string GetId(string userName, string shortTemplateId, out ErrorMessage errorMessage)
注意:(1)如果尚未添加模板,该⽅法会先添加模板,然后返回模板id;(2)如果已经添加了模板,再次调⽤该⽅法,会返回⼀个新的不同于上次获取到的模板id。
获得模板id的⽰例:
/// <summary>
///添加并模板id
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
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⽅法⽤于发送模板消息,该⽅法定义如下:
/
// <summary>
///发送模板消息
/// </summary>
/// <param name="userName"></param>
/// <param name="touser">接收消息的账号</param>
/// <param name="templateId">模板id</param>
/// <param name="detailUrl">详情地址</param>
/// <param name="topColor">顶端颜⾊</param>
/// <param name="data">数据</param>
/// <param name="errorMessage">返回发送是否成功</param>
/// <returns>返回消息id;如果发送失败,返回-1。</returns>
public static long Send(string userName, string touser, string templateId, string detailUrl, Color topColor,
Tuple<string, string, Color>[] data, out ErrorMessage errorMessage)
其中,data参数为Tuple类型,包含模板所⽤的数据,data.Item1为数据键,data.Item2为数据值,data.Item3为显⽰数据的颜⾊。
发送模板消息的⽰例:
/// <summary>
///发送模板消息
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void btnSend_Click(object sender, EventArgs e)
{
if (rblUser.SelectedIndex >= 0)
化妆品店名{
string userName = lbPublicAccount.SelectedValue;
string openId = rblUser.SelectedValue;
string templateId = "z8zHvTm2gpU0gZUBwA0dXibMO_VYy6iwJYgtW6qeyPg";
string title = txtTitle.Text;
string name = txtUserName.Text;
string time = DateTime.Now.ToString();
Tuple<string, string, Color>[] data = new Tuple<string, string, Color>[]{
new Tuple<string,string,Color>("title",title,Color.Blue),
new Tuple<string,string,Color>("username",name,Color.Green),
new Tuple<string,string,Color>("time",time,Color.Red)
};
ErrorMessage errorMessage;
long msgId = TemplateMessage.Send(userName, rblUser.SelectedValue, templateId, "", Color.Black, data, out errorMessage);
if (errorMessage.IsSuccess)
ltrMessage.Text = string.Format("发送模板消息成功。消息id:{0}", msgId);
else
ltrMessage.Text = string.Format("发送模板消息失败。{0}", errorMessage);
}
}
发送模板消息⽰例
5 接收推送模板消息发送结果事件
在发送模板消息之后,服务器会推送结果到的指定URL上,服务器会接收到⼀条RequestTemplateSendJobFinishMessage类型的请求消息。
RequestTemplateSendJobFinishMessage类有以下只读属性:
/// <summary>
///获取消息id
/// </summary>
public long MsgID { get; private set; }
/// <summary>
///获取发消息的结果
/// </summary>
public string Status { get; private set; }
/// <summary>
///获取消息是否发成功
司藤单志刚是什么人/// </summary>
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;
内蒙旅游景点}
}
发布评论