企业微信功能日益强大，腾讯官方也提供了丰富的API供开发者实现企业微信的很多自动化场景。比如，如何给某个企业微信群发送消息、图片或者文件，甚至@指定群用户？别急，看小爬君轻松教会大家。
Step1：在企业微信PC端或者移动端找几个用户创建一个企业微信群（步骤略过）；
STEP2：在企业微信群中添加一个【群机器人】；
点击企业微信群聊天界面，点击右上角【···】按钮，然后点击【添加群机器人】，如下图所示：
然后，我们在该企业微信群就能看到群成员【群机器人】了，在群成员界面，鼠标悬停在该【群机器人】位置，就可以看到该机器人的具体信息，如下图所示：
有了上面的两个步骤，这样一个专属的群机器人就创建好了，其中上图中的Webhook属性（url地址）是该机器人的关键信息，类似于机器人ID。
现在我们来看下如何用该群机器人往群里发消息，发图片，发文件。想要看完整的企业微信API文档的，请移步【腾讯企业微信开发者中心】页面：群机器人配置说明 - 文档 - 企业微信开发者中心 (qq.com)
一、发送文本类型数据
{ "msgtype": "text", "text": { "content": "广州今日天气：29度，大部分多云，降雨概率：60%", "mentioned_list":["wangqing","@all"], "mentioned_mobile_list":["13800001111","@all"] } }
| 参数 | 是否必填 | 说明 |
|---|---|---|
| msgtype | 是 | 消息类型，此时固定为text |
| content | 是 | 文本内容，最长不超过2048个字节，必须是utf8编码 |
| mentioned_list | 否 | userid的列表，提醒群中的指定成员(@某个成员)，@all表示提醒所有人，如果开发者获取不到userid，可以使用mentioned_mobile_list |
| mentioned_mobile_list | 否 | 手机号列表，提醒手机号对应的群成员(@某个成员)，@all表示提醒所有人 |
用python来实现的代码示例如下：
1 import os,re,time,datetime,base64,requests,json 2 from requests_toolbelt import MultipartEncoder 3 import json 4 5 def SendGroupMsg(textContent, webHookUrl, mentioned_list=[],mentioned_mobile_list=[]): 6 """ 7 发送微信群组机器人消息 8 :param textContent: 消息内容 9 :param webHookUrl: 群组机器人WebHook 10 :param mentioned_list: userid的列表，提醒群中的指定成员(@某个成员)，@all表示提醒所有人 11 :param mentioned_mobile_list: 手机号列表，提醒手机号对应的群成员(@某个成员)，@all表示提醒所有人 12 :return: 13 """ 14 # url为群组机器人WebHook，配置项 15 url = webHookUrl 16 headers = { 17 "content-type": "application/json" 18 } 19 msg = {"msgtype": "text", 20 "text": { 21 "content": textContent, 22 "mentioned_list":mentioned_list, 23 "mentioned_mobile_list": mentioned_mobile_list 24 }} # 发送文本消息 25 # 由于API接收的是json字符串，故需要转化一下 26 data = json.dumps(msg, ensure_ascii=False).encode('utf-8') 27 # 发送请求 28 try: 29 result = requests.post(url, headers=headers, data=data) 30 return True 31 except Exception as e: 32 # print("Requset Failed:", e) 33 return False
二、发送群文件
{ "msgtype": "file", "file": { "media_id": "3a8asd892asd8asd" } }
在发送文件之前，我们需要请求如下接口，获取到media_id参数。
文件上传接口
素材上传得到media_id，该media_id仅三天内有效
media_id只能是对应上传文件的机器人可以使用
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=KEY&type=TYPE
使用multipart/form-data POST上传文件， 文件标识名为"media"
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| key | 是 | 调用接口凭证, 机器人webhookurl中的key参数 |
| type | 是 | 固定传file |
POST的请求包中，form-data中媒体文件标识，应包含有 filename、filelength、content-type等信息
filename标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制
有了这两个接口的API，用python来实现【发送群文件】就不是难题了：
import os,re,time,datetime,base64,requests,json from requests_toolbelt import MultipartEncoder from urllib import parse import json
def SendGroupFile(filepath, webHookUrl): """ 发送微信群组机器人文件 :param filepath: 文件路径 :param webHookUrl: 群组机器人WebHook :return: """ # url为群组机器人WebHook，配置项 url = webHookUrl headers = { "content-type": "application/json" } # 发送文件需要先上传文件获取media_id media_id = UploadFile(filepath, url) req_json = dict() req_json["msgtype"] = "file" req_json["file"] = dict() req_json["file"]["media_id"] = media_id # 发送请求 try: result = requests.post(url, headers=headers, json=req_json) return True except Exception as e: print("企业微信机器人发送文件失败,详细信息:" + str(e)) return False def UploadFile(filepath, webHookUrl): """ 企业微信机器人上传文件，发送文件前需要先上传--要求文件大小在5B~20M之间 :param filepath: 文件路径 :param webHookUrl: 群组机器人WebHook :return: media_id """ # url为群组机器人WebHook，配置项 url = webHookUrl params = parse.parse_qs( parse.urlparse( webHookUrl ).query ) webHookKey=params['key'] upload_url = f'https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key={webHookKey}&type=file' headers = {"Accept": "application/json, text/plain, */*", "Accept-Encoding": "gzip, deflate", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.100 Safari/537.36"} filename = os.path.basename(filepath) try: multipart = MultipartEncoder( fields={'filename': filename, 'filelength': '', 'name': 'media', 'media': (filename, open(filepath, 'rb'), 'application/octet-stream')}, boundary='-------------------------acebdf13572468') headers['Content-Type'] = multipart.content_type resp = requests.post(upload_url, headers=headers, data=multipart) json_res = resp.json() if json_res.get('media_id'): # print(f"企业微信机器人上传文件成功，file:{filepath}") return json_res.get('media_id') except Exception as e: # print(f"企业微信机器人上传文件失败，file: {filepath}, 详情：{e}") print("企业微信机器人上传文件失败,详细信息:" + str(e)) return ""
感兴趣的童鞋，快动手试试吧！
快来扫码关注我的公众号 获取更多爬虫、数据分析的知识！
