一。建立聊天群,并创建聊天机器人,获取聊天机器人的Key
企业微信 获取消息机器人 地址 和 Key 的操作步骤
1.有企业微信,必须是企业微信。
2.然后在企业微信中建一个群聊,至少要有3个人。
3.进入到群的聊天页面后,点击页面右上角的 。。。 图标。
4.此时会弹出【聊天信息】页面,接着再点击页面中的【群机器人】功能。
5.接着再点击【群机器人】页面底部的【添加机器人】功能。
6.之后再在【添加机器人】页面中设置机器人的名字,接着再点击【添加】功能。
7.接着再点击新页面右上角的【完成】功能,这样就成功的添加企业微信群机器人了。
8.机器人信息内可以看到机器人的webhook地址,包含机器人Key,拷贝出来备用。
二。使用样例代码,即可给指定的机器人发送文本消息或格式消息,指定的聊天群所有人即可收到该消息
/// <summary> /// 企业微信 Webhook消息 /// </summary> public static class WXWebhookHelper { // 消息机器人 接口地址,所有机器人地址都是一样的 private static string _msgUrl = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send"; /// <summary> /// 文本消息 /// 给指定的消息机器人发送消息 /// </summary> /// <param name="key">机器人Key</param> /// <param name="msg">消息内容</param> public static async Task<WXWebhookReturnData> SentText(string key, string msg) { string sentUrl = $"{_msgUrl}?key={key}"; WXWebhookText data = new WXWebhookText() { msgtype = "text", text = new() { content = msg, }, }; return await FluentHelper.PostAsync<WXWebhookReturnData>(sentUrl, data); } /// <summary> /// 格式消息 /// 给指定的机器人发送消息 /// </summary> /// <param name="key">机器人Key</param> /// <param name="type">类型</param> /// <param name="title">标题</param> /// <param name="from">来源</param> /// <param name="msg">消息内容</param> /// <returns></returns> public static async Task<WXWebhookReturnData> Sent(string key, string type, string title, string from, string msg, string url) { string sentUrl = $"{_msgUrl}?key={key}"; string content = $"# {title} \n " + $">消息:<font color=\"comment\">{msg}</font> \n" + $">时间:<font color=\"comment\">{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")}</font> \n" + $">来源:<font color=\"comment\">{from}</font> \n" + $">类型:<font color=\"comment\">{type}</font> \n"; if (!string.IsNullOrWhiteSpace(url)) { content += $">地址:<font color=\"info\">[点击打开]({url})</font> \n"; } WXWebhookMarkDown data = new WXWebhookMarkDown() { msgtype = "markdown", markdown = new() { content = content, }, }; return await FluentHelper.PostAsync<WXWebhookReturnData>(sentUrl, data); } }主要用于:预警、提醒等消息的实时推送,优点是随时可以通过加群、退群变更消息的接收群体,而无需修改代码或更改设置
|
|