### 实现企业微信机器人推送图片和文件的功能 要通过 Python 使用企业微信机器人 API 推送图片和文件，可以参考官方文档以及现有的接口设计[^1]。以下是具体方法： #### 图片推送 企业微信支持通过 `media_id` 来发送图片消息。为了实现这一目标，需要分两步完成操作： 1. **上传临时素材**：调用 `/cgi-bin/media/upload` 接口来获取媒体文件的 `media_id`。 2. **发送图片消息**：利用获得的 `media_id` 调用 Webhook 发送图片。 下面是完整的代码示例： ```python import requests from pathlib import Path def upload_media(file_path, media_type="image"): """ 上传临时素材到企业微信服务器，返回 media_id。 :param file_path: 文件路径 :param media_type: 媒体类型，默认为 image :return: 返回 media_id 或错误信息 """ webhook_key = "你的webhook密钥" base_url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key={webhook_key}&type={media_type}" files = {'file': (Path(file_path).name, open(file_path, 'rb'))} response = requests.post(base_url, files=files) result = response.json() if result.get('errcode') == 0: return result['media_id'] else: raise Exception(f"Upload failed: {result}") def send_image(media_id): """ 使用 media_id 发送图片消息 :param media_id: 已经上传成功的媒体ID """ webhook_url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的webhook密钥" payload = { "msgtype": "image", "image": { "media_id": media_id } } headers = {"Content-Type": "application/json"} response = requests.post(webhook_url, json=payload, headers=headers) result = response.json() if result.get('errcode') != 0: raise Exception(f"Send image failed: {result}") # 示例使用 try: media_id = upload_media("example.jpg") send_image(media_id) except Exception as e: print(e) ``` 上述代码实现了两个主要功能函数——`upload_media()` 和 `send_image()`。前者负责将本地文件上传至企业微信服务器并返回其对应的 `media_id`；后者则基于此 ID 向指定的企业微信群组发送该图片资源。 --- #### 文件推送 对于文件类型的推送逻辑基本一致，只是在第一步中需设置参数 `media_type='file'` 并调整后续 JSON 数据结构中的字段名称匹配实际需求即可。下面给出相应修改后的版本供参考： ```python def send_file(media_id): """ 使用 media_id 发送文件消息 :param media_id: 已经上传成功的媒体ID """ webhook_url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的webhook密钥" payload = { "msgtype": "file", "file": { "media_id": media_id } } headers = {"Content-Type": "application/json"} response = requests.post(webhook_url, json=payload, headers=headers) result = response.json() if result.get('errcode') != 0: raise Exception(f"Send file failed: {result}") # 示例使用 try: media_id = upload_media("document.pdf", media_type="file") send_file(media_id) except Exception as e: print(e) ``` 这里需要注意的是，在调用 `upload_media()` 方法时传入 `"file"` 参数作为第二项输入值以表明当前处理对象属于普通附件而非图像资料。 --- #### 注意事项 - 需要确保已正确配置好对应的应用权限及 Secret Key 才能正常使用这些高级特性。 - 如果遇到任何异常情况（比如网络连接失败或者认证过期等问题），可以通过捕获抛出的具体错误描述来进行诊断分析。