首页 > 营销学院 > 技术知识

如何通过PHP调用企业微信机器人接口_PHP企业微信机器人接口调用与消息推送教程

答案：通过企业微信机器人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请求即可。

消息类型：设置为"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