企业微信机器人推送

### 企业微信机器人消息推送的配置方法和实现步骤 #### 配置方法 1. **创建群机器人**： - 登录企业微信管理后台。 - 进入“应用管理” -> “群机器人” -> 点击“添加”按钮。 - 填写机器人名称并选择需要加入的群组，保存后会生成一个Webhook地址，其中包含一个唯一的`key`值。该地址用于后续的消息推送请求。 2. **获取Webhook地址**： - 创建完成后，系统会提供一个类似`https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={key}`的URL，其中`{key}`是唯一标识符。 - 该地址将用于发送HTTP POST请求以推送消息到指定的企业微信群。 #### 实现步骤 1. **准备开发环境**： - 确保已安装Java或Python等编程语言的开发环境。 - 如果使用Java，确保引入了Forest库或其他HTTP客户端库。 - 如果使用Python，确保安装了`requests`库，可以通过`pip install requests`进行安装。 2. **编写代码实现消息推送**： - **Java实现（使用Forest库）**： ```java import com.dtflys.forest.annotation.JSONBody; import com.dtflys.forest.annotation.Post; import com.dtflys.forest.annotation.Var; import org.springframework.stereotype.Component; import java.util.Map; @Component public interface WechatNoticeClient { @Post( url = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={key}", headers = { "Accept-Charset: utf-8", "Content-Type: application/json" }, dataType = "json" ) void sendWechatMsg(@Var("key") String key, @JSONBody Map<String, Object> body); } ``` 在调用此接口时，传入`key`和消息体`body`即可发送消息[^1]。 - **Python实现（使用`requests`库）**： ```python import requests import json def send_wechat_message(key, message): webhook_url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={key}" data = { "msgtype": "text", "text": { "content": message, "mentioned_list": ["@all"] # 可选参数，指定提醒的成员 } } response = requests.post(webhook_url, data=json.dumps(data)) return response.json() # 示例调用 key = "your_unique_key_here" message = "这是一条测试消息！" result = send_wechat_message(key, message) print(result) ``` 3. **测试消息推送**： - 调用上述编写的代码，传入正确的`key`和消息内容，检查是否能够成功接收到消息。 - 如果遇到错误，查看返回结果中的错误码和描述，根据官方文档排查问题。 4. **定时任务配置**： - 如果需要定时推送消息，可以使用Windows任务计划或Linux的Cron作业。 - 对于Python脚本，确保已正确安装Python环境，并将脚本路径添加到系统环境变量中。 - 配置任务计划时，设置触发器和操作，指定执行时间和要运行的脚本路径。 #### 消息格式说明 - **文本消息**： ```json { "msgtype": "text", "text": { "content": "消息内容", "mentioned_list": ["@all", "userid1", "userid2"] // 可选参数，指定提醒的成员 } } ``` - **Markdown消息**： ```json { "msgtype": "markdown", "markdown": { "content": "实时新增用户反馈<font color=\"comment\">132例</font>，请相关同事注意。\n> 类型:<font color=\"info\">用户反馈</font> \n> 普通用户反馈：117例\n> VIP用户反馈：15例" } } ``` - **图文消息**： ```json { "msgtype": "news", "news": { "articles": [ { "title": "中秋节放假安排", "description": "中秋节即将来临，请合理安排假期时间。", "url": "http://example.com", "picurl": "http://example.com/image.jpg" } ] } } ``` #### 注意事项 - **安全性**：不要将`key`暴露给他人，避免被恶意使用。 - **频率限制**：企业微信对消息推送有频率限制，具体请参考官方文档。 - **调试工具**：可以使用Postman等工具手动发送POST请求，验证Webhook地址的有效性。