答案:通过企业微信机器人Webhook URL用PHP的cURL发送JSON格式POST请求可实现消息推送。首先在群聊中添加机器人获取唯一Webhook地址,然后构造包含msgtype、content等字段的JSON数据,使用cURL设置请求头为application/json并发送,最后检查HTTP状态码及返回结果判断是否成功,支持文本、图文等多种消息类型。

调用企业微信机器人接口,核心是向其Webhook URL发送POST请求。PHP实现起来非常直接,不需要复杂的认证流程,基本上就是构造数据并用curl或file_get_contents发出去。
获取机器人Webhook地址
这是第一步,也是最关键的一步。你需要在企业微信群里添加一个“群机器人”:
- 打开企业微信,进入你想要推送消息的群聊
- 点击右上角的“...”菜单,找到“群机器人”
- 点击“添加机器人”,设置名称,系统会生成一个唯一的Webhook URL
- 复制并保存这个URL,它长这样:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的唯一密钥
注意:这个密钥(key)是公开的,谁拿到都能发消息,所以要妥善保管,避免泄露。
使用PHP发送文本消息
这是最常用的功能。只需要使用PHP的cURL库,向Webhook URL发送一个JSON格式的POST请求即可。
立即学习“PHP免费学习笔记(深入)”;
- 消息类型:设置为"text"
- 内容:在"content"字段里填写你要发送的文字
- 提及成员:可以用"mentioned_list"字段指定@哪些人,填他们的userid;用"@all"可以提醒所有人
示例代码:
'text',
'text' => array(
'content' => "这是一条由PHP脚本自动发送的测试消息!\n任务已经成功执行。",
'mentioned_list' => array('userid1', '@all') // 可选:需要@的人,填userid,或者用@all
)
);
// 3. 使用cURL发送POST请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $webhookUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($messageData)); // 将数组转换为JSON字符串
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 不直接输出,而是返回结果
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 获取HTTP状态码
curl_close($ch);
// 4. 检查发送结果
if ($httpCode == 200) {
$result = json_decode($response, true);
if ($result['errcode'] == 0) {
echo "消息发送成功!";
} else {
echo "消息发送失败,错误信息:" . $result['errmsg'];
}
} else {
echo "HTTP请求失败,状态码:" . $httpCode;
}
?>
发送其他类型的消息
除了文本,机器人还支持图文、文件等多种消息。方法一样,只是要调整JSON里的`msgtype`和对应的数据结构。
比如发送一条图文消息(news),示例代码片段如下:
$messageData = array(
'msgtype' => 'news',
'news' => array(
'articles' => array(
array(
'title' => '这是一个新闻标题',
'description' => '这是描述文字...',
'url' => 'https://example.com/article',
'picurl' => 'https://example.com/image.jpg' // 图片链接
)
// 可以添加更多文章
)
)
);
// 然后用上面相同的cURL方法发送 $messageData
基本上就这些,不复杂但容易忽略细节,比如URL写错、JSON格式不对。确保你的PHP环境能正常发起网络请求,就可以稳定地把告警、日志或通知推送到企业微信群了。











