PHP如何批量发送微信模板消息

微信模板消息是一种有效的客户沟通方式，通过它可以将具体信息推送给指定的用户。在PHP环境下批量发送微信模板消息需要完成以下几个核心步骤：获取微信accessToken、构建模板消息数据、使用微信提供的接口发送消息。这要求具备访问微信公众平台API的权限，并对相应的API接口有一定的了解。

具体来说，首先要获取用户的OpenID列表，然后构造模板消息内容，再将构造好的内容通过调用微信发送接口来实现消息推送。这一流程在处理大量消息时需要注意性能和稳定性，你可能需要一些消息队列工具如RabbitMQ，以及对并发控制和错误处理有所了解。

一、获取ACCESS TOKEN

首先，批量发送前提是拥有有效的access token。Access token是微信API访问的凭证，通常有较短的有效期，需要定期刷新。

• 获取token

  注册并认证微信公众号后，可以在后台获取到AppID和AppSecret。通过发送HTTP请求到微信的接口传递这两个参数，就能获得access token。

$appId = "YOUR_APP_ID";

$appSecret = "YOUR_APP_SECRET";
$getTokenUrl = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appId&secret=$appSecret";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $getTokenUrl);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);
$tokenData = json_decode($response, true);
if (isset($tokenData['access_token'])) {
    $accessToken = $tokenData['access_token'];
} else {
    die("FAIled to receive access token");
}

• 存储token

  考虑到access token的有效性，可以将其存储在数据库中，并设置好过期时间。在使用前先检查token是否过期，如果过期则重新获取。

二、获取用户OPENID列表

要批量发送消息，需要先获取所有需要接收消息用户的OpenID。

• 获取用户列表

  调用微信公众号API获取用户列表，使用前面获取的access token来完成这一步骤。

$userListUrl = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=$accessToken";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $userListUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$userResponse = curl_exec($ch);
$userListData = json_decode($userResponse, true);
curl_close($ch);
if (isset($userListData['data']['openid'])) {
    $userOpenIds = $userListData['data']['openid'];
} else {
    die("Failed to get user list");
}

三、构造模板消息数据

对于每个用户，需要构造不同的模板消息内容。在这一步中，需要根据事先在微信公众号平台定义的模板进行内容填充。

• 构造消息

  根据微信模板消息的格式要求，准备具体的消息数据。

$templateId = "YOUR_TEMPLATE_ID";

$templateUrl = "SOME_URL";
$templateData = [
    'first' => [
        'value' => "亲爱的用户，您有新的通知",
        'color' => "#173177"
    ],
    // 其他模板内定义的字段...
];
$message = [
    'touser' => "",
    'template_id' => $templateId,
    'url' => $templateUrl,
    'data' => $templateData
];

四、发送模板消息

将构造好的模板数据逐个发送到微信公众号的消息接口，完成消息发送。

• 发送消息

  通过循环用户列表，为每个用户调用发送接口。

$sendMessageUrl = "https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=$accessToken";

foreach ($userOpenIds as $openId) {
    $message['touser'] = $openId;
    $jsonMessage = json_encode($message);
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $sendMessageUrl);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonMessage);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $result = curl_exec($ch);
    curl_close($ch);
    // 你可以根据$result中的errcode等字段来判断消息是否发送成功，并做相应处理
}

• 错误处理

  每次发送可能会有失败的情况，需要记录错误信息，并进行重试或其他处理。

foreach ($userOpenIds as $openId) {

    // ... 发送消息代码
    $result = curl_exec($ch);
    curl_close($ch);
    $resArray = json_decode($result, true);
    if ($resArray['errcode'] != 0) {
        // 记录错误信息，继续发送或通知管理员
    }
}

五、优化和注意事项

在批量发送微信模板消息时需要注意以下几点：

• 消息发送频率限制：微信官方有API调用频率限制，如果超出了限制会发送失败。在设计消息批量发送功能时，需要考虑这一点。
• 并发处理：如果用户量大，单线程发送可能效率低下，可以考虑并发发送，但并发数不宜过大，以免触发微信的频率限制。
• 失败重试策略：考虑实现失败重试机制，对于发送失败的消息进行重试。
• 日志记录：详细记录发送日志，方便出现问题时追溯和定位。

通过以上步骤，就可以在PHP环境下实现对微信模板消息的批量发送。在实际操作中，需要结合微信公众号的实际情况调整参数和代码逻辑，以确保功能的正常运作。

相关问答FAQs：

1. 如何使用PHP批量发送微信模板消息？

发送微信模板消息可以使用PHP的cURL库来实现。首先，你需要获取到微信的access_token，然后将模板消息的内容与接收者的openid构建成一个json格式的数据，并使用cURL库将数据POST给微信的模板消息接口。

2. 有没有现成的PHP类库可以用来批量发送微信模板消息？

是的，有许多开源的PHP类库可以帮助你轻松地批量发送微信模板消息。比如，EasyWeChat、Wechat-php-sdk等类库都提供了方便的接口用于发送模板消息。

3. 是否可以使用第三方平台来批量发送微信模板消息？

是的，你可以使用第三方平台来批量发送微信模板消息。许多第三方平台，如腾讯云、阿里云等，都提供了方便的API接口，可以帮助你轻松地实现批量发送微信模板消息的功能。只需根据其提供的文档和示例代码，将你的消息内容进行组装并发送即可。