### 如何使用 Python 实现企业微信机器人发送本地图片作为图文消息 要实现通过 Python 调用企业微信机器人接口来发送本地图片并将其转换为图文消息，需要遵循以下逻辑： #### 1. 准备工作 在开始之前，需确认已获取企业微信机器人的 Webhook URL。该 URL 是企业在配置群机器人时由平台自动生成的唯一访问入口[^1]。 此外，由于企业微信机器人本身并不直接支持上传本地文件，因此需要先将本地图片上传至第三方存储服务（如腾讯云 COS 或其他公开图床），再通过返回的公网链接构建图文消息格式。 --- #### 2. 构建图文消息格式 企业微信机器人支持的消息类型中，“图文”是一种常见的形式。其 JSON 数据结构如下所示[^2]: ```json { "msgtype": "news", "news": { "articles": [ { "title": "标题", // 文章标题 "description": "描述", // 描述文字（可选） "url": "跳转链接", // 用户点击后跳转的目标URL "picurl": "图片链接" // 图片的公网URL } ] } } ``` 其中 `picurl` 字段用于指定图片资源的位置，而此位置必须是一个可以通过 HTTP(S) 访问的有效地址。 --- #### 3. 使用 Python 编写代码 以下是完整的 Python 示例代码，展示如何读取本地图片、上传至云端以及最终调用企业微信 API 完成消息推送: ```python import requests from pathlib import Path def upload_image_to_cos(image_path, cos_bucket_url): """ 将本地图片上传到COS或其他图床上，并返回公网访问路径。 参数: image_path (str): 本地图片路径 cos_bucket_url (str): 对应图床的基础域名 返回: str: 成功后的图片公网URL """ file_name = Path(image_path).name with open(image_path, 'rb') as f: files = {'file': (file_name, f)} response = requests.post(f"{cos_bucket_url}/upload", files=files) if response.status_code == 200 and 'data' in response.json(): return response.json()['data']['url'] raise Exception("图片上传失败") def send_wechat_message(webhook_url, title, description, url, picurl): """ 向企业微信机器人发送图文消息。 参数: webhook_url (str): 企业微信机器人Webhook地址 title (str): 消息标题 description (str): 消息描述 url (str): 点击消息后跳转的链接 picurl (str): 图片的公网URL """ payload = { "msgtype": "news", "news": { "articles": [ { "title": title, "description": description, "url": url, "picurl": picurl } ] } } headers = {"Content-Type": "application/json"} response = requests.post(webhook_url, json=payload, headers=headers) if response.status_code != 200 or response.json().get('errcode') != 0: raise Exception(f"消息发送失败: {response.text}") if __name__ == "__main__": # 配置项 WEBHOOK_URL = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_key_here" COS_BUCKET_URL = "http://example.cos.region.myqcloud.com" IMAGE_PATH = "./local_image.jpg" TITLE = "测试标题" DESCRIPTION = "这是测试描述内容" CLICK_URL = "https://www.example.com" try: # 步骤1: 上传图片获得公网链接 public_pic_url = upload_image_to_cos(IMAGE_PATH, COS_BUCKET_URL) # 步骤2: 发送图文消息 send_wechat_message(WEBHOOK_URL, TITLE, DESCRIPTION, CLICK_URL, public_pic_url) print("消息发送成功!") except Exception as e: print(e) ``` 上述代码实现了两个核心功能：一是利用外部图床服务完成图片托管；二是按照企业微信定义的数据协议封装请求体并向目标端点发起 POST 请求[^3]。 --- #### 注意事项 - **安全性**: 如果涉及敏感数据传输，请确保 HTTPS 协议启用以保护通信安全。 - **频率控制**: 根据官方文档说明，单个机器人每分钟最多允许触发 20 条消息推送操作[^1]。 - **错误处理**: 增加必要的异常捕获机制以便及时发现潜在问题所在。 ---