企业微信机器人实战：从文本到图文，一站式消息推送指南

1. 企业微信机器人入门指南

第一次接触企业微信机器人时，我完全被它的强大功能震撼到了。想象一下，你正在度假，突然服务器崩溃了，而机器人能立即在企业微信群里发出告警，附带详细的错误日志和解决方案建议。这种自动化通知能力，正是现代开发运维工作中最需要的利器。

企业微信机器人本质上是一个Webhook接口，通过简单的HTTP请求就能实现消息推送。它支持文本、图片、文件、Markdown和图文五种消息类型，几乎覆盖了所有常见的通知场景。我在三个不同项目中部署过这个功能，从简单的日报推送到复杂的监控系统集成，它的稳定性和易用性始终让我惊喜。

要创建一个机器人非常简单：

1. 在企业微信PC端打开目标群聊
2. 点击右上角下拉菜单选择"添加群机器人"
3. 设置机器人名称并获取Webhook地址

这个地址看起来像这样：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxx-xxxx-xxxx。千万要保管好这个key，它就像是机器人的密码，任何人拿到这个地址都能往你的群里发消息。

2. 文本消息：最基础的告警通知

文本消息是企业微信机器人最基础也最常用的功能。我在搭建监控系统时，第一个实现的就是文本告警功能。当服务器CPU使用率超过90%时，一条醒目的消息会立即出现在运维群里：

def send_text_alert(alert_msg): webhook_url = "你的机器人Webhook地址" payload = { "msgtype": "text", "text": { "content": alert_msg, "mentioned_mobile_list": ["13800138000"] # 要@的成员手机号 } } response = requests.post(webhook_url, json=payload) return response.json()

这个简单的函数却能解决大问题。几个实用技巧：

• 使用mentioned_mobile_list可以@特定成员
• 消息内容支持换行符\n来格式化文本
• 建议在内容前加上emoji符号增加可读性，比如" CPU告警"

我在实际使用中发现，纯文本消息最适合简短、即时的通知。比如：

• 任务执行成功/失败提示
• 简单的系统状态更新
• 需要立即响应的告警信息

3. 图片消息：让告警更直观

当我们需要展示图表、截图或者可视化数据时，图片消息就派上用场了。记得有一次服务器磁盘爆满，光看文字描述很难定位问题，后来我在告警里加了磁盘使用情况的截图，问题一目了然。

发送图片需要先将图片转为base64编码和MD5校验值：

def prepare_image(image_path): with open(image_path, "rb") as image_file: image_data = image_file.read() base64_str = base64.b64encode(image_data).decode('utf-8') md5_hash = hashlib.md5(image_data).hexdigest() return base64_str, md5_hash def send_image(image_path): base64_str, md5_hash = prepare_image(image_path) payload = { "msgtype": "image", "image": { "base64": base64_str, "md5": md5_hash } } response = requests.post(WEBHOOK_URL, json=payload) return response.json()

图片消息最适合这些场景：

• 展示数据可视化图表
• 分享界面截图或错误页面
• 发送二维码或其他图形信息

需要注意的是，企业微信对图片大小有限制（不超过2MB），大图片需要先压缩。我通常会使用Pillow库来自动压缩图片：

from PIL import Image def compress_image(input_path, output_path, quality=85): with Image.open(input_path) as img: img.save(output_path, quality=quality)

4. 文件传输：日志和报表分享

当我们需要分享日志文件、数据报表或其他文档时，文件消息类型就非常实用了。与企业微信普通文件上传不同，机器人发送文件需要分两步：先上传文件获取media_id，再用这个id发送消息。

文件上传函数示例：

def upload_file(file_path): upload_url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key={KEY}&type=file" with open(file_path, 'rb') as f: files = {'media': f} response = requests.post(upload_url, files=files) return response.json() def send_file(file_path): upload_result = upload_file(file_path) if upload_result['errcode'] != 0: return upload_result payload = { "msgtype": "file", "file": { "media_id": upload_result['media_id'] } } response = requests.post(WEBHOOK_URL, json=payload) return response.json()

文件传输功能特别适合这些场景：

• 每日自动发送数据报表
• 系统错误时附带完整日志
• 分享需要下载查看的文档

我在实际使用中遇到过几个坑：

1. 文件大小限制20MB，大文件需要先分割
2. 上传的media_id有效期只有3天
3. 文件名中不要包含特殊字符，否则可能下载失败

5. Markdown消息：专业级的报告格式

Markdown是我最喜欢的企业微信机器人功能，它能让消息变得专业又美观。我们团队的每日运营报告就是用Markdown格式发送的，包含彩色文字、引用块和精细的排版。

一个典型的Markdown消息示例：

def send_markdown(): content = """ ### 昨日运营数据报告 > **总用户数**: <font color=\"info\">15,328</font> (+213) > **新增订单**: <font color=\"warning\">1,245</font> > **投诉率**: <font color=\"comment\">0.8%</font> [点击查看详情](https://dashboard.example.com) """ payload = { "msgtype": "markdown", "markdown": { "content": content } } response = requests.post(WEBHOOK_URL, json=payload) return response.json()

Markdown支持的特性包括：

• 多级标题（###）
• 字体颜色（）
• • 引用块（>）
  • 超链接（文字）
  • 行内代码（code）

def send_news(title, description, url, image_url): payload = { "msgtype": "news", "news": { "articles": [ { "title": title, "description": description, "url": url, "picurl": image_url } ] } } response = requests.post(WEBHOOK_URL, json=payload) return response.json()

response = send_message(payload) if response.get('errcode') != 0: logging.error(f"消息发送失败: {response['errmsg']}") # 重试逻辑或通知管理员