位置：文档库 > PHP > 如何使用PHP实现公众号的客服消息发送功能

如何使用PHP实现公众号的客服消息发送功能

三五明月满上传于 2022-01-08 02:00

《如何使用PHP实现公众号的客服消息发送功能》

随着微信公众号的普及，越来越多的企业和开发者希望通过公众号与用户建立更直接的互动渠道。客服消息功能作为公众号的核心交互方式之一，允许开发者主动向用户推送文本、图片、图文等消息，提升用户体验和服务效率。本文将详细介绍如何使用PHP实现微信公众号的客服消息发送功能，涵盖从基础配置到实际代码实现的全流程。

一、准备工作

在开始开发前，需完成以下准备工作：

注册微信公众号（服务号）：客服消息功能仅支持已认证的服务号，个人订阅号无法使用。
获取开发者权限：在公众号后台的“开发”-“基本配置”中开启开发者模式，记录AppID和AppSecret。
配置服务器：需拥有一台可访问的公网服务器，用于接收微信服务器的请求。
获取Access Token：调用微信接口的凭证，有效期为2小时，需定时刷新。

二、获取Access Token

Access Token是调用微信公众平台API的“钥匙”，所有接口请求均需携带该参数。以下是使用PHP获取Access Token的代码示例：

function getAccessToken($appId, $appSecret) {
    $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appId}&secret={$appSecret}";
    $response = file_get_contents($url);
    $data = json_decode($response, true);
    return $data['access_token'];
}

建议将Access Token缓存到数据库或文件中，避免频繁请求导致接口限制。

三、客服消息接口说明

微信提供了客服消息接口，允许开发者通过POST请求向指定用户发送消息。接口地址为：

https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

支持的消息类型包括：

文本消息（text）
图片消息（image）
图文消息（news）
菜单消息（menu）
视频消息（video）
语音消息（voice）

四、发送文本消息实现

以下是发送文本客服消息的完整PHP代码示例：

function sendTextMessage($accessToken, $openId, $content) {
    $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token={$accessToken}";
    $data = [
        'touser' => $openId,
        'msgtype' => 'text',
        'text' => [
            'content' => $content
        ]
    ];
    $options = [
        'http' => [
            'method' => 'POST',
            'header' => 'Content-type: application/json',
            'content' => json_encode($data)
        ]
    ];
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    return json_decode($result, true);
}

调用示例：

$appId = '你的AppID';
$appSecret = '你的AppSecret';
$openId = '用户的OpenID';
$accessToken = getAccessToken($appId, $appSecret);
$result = sendTextMessage($accessToken, $openId, '您好，欢迎使用我们的服务！');
print_r($result);

五、发送图文消息实现

图文消息（news）支持发送多条图文，每条图文包含标题、描述、图片URL和点击URL。以下是实现代码：

function sendNewsMessage($accessToken, $openId, $articles) {
    $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token={$accessToken}";
    $data = [
        'touser' => $openId,
        'msgtype' => 'news',
        'news' => [
            'articles' => $articles
        ]
    ];
    $options = [
        'http' => [
            'method' => 'POST',
            'header' => 'Content-type: application/json',
            'content' => json_encode($data)
        ]
    ];
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    return json_decode($result, true);
}

// 调用示例
$articles = [
    [
        'title' => '第一条图文标题',
        'description' => '第一条图文描述',
        'url' => 'https://example.com/article1',
        'picurl' => 'https://example.com/image1.jpg'
    ],
    [
        'title' => '第二条图文标题',
        'description' => '第二条图文描述',
        'url' => 'https://example.com/article2',
        'picurl' => 'https://example.com/image2.jpg'
    ]
];
$result = sendNewsMessage($accessToken, $openId, $articles);
print_r($result);

六、错误处理与调试

微信接口返回的错误码需进行妥善处理，常见错误包括：

40001：Access Token无效
45009：接口调用超过限制
45015：回复时间超过限制（客服消息需在48小时内回复用户）
45058：消息内容包含敏感词

建议封装统一的错误处理函数：

function handleWeChatError($response) {
    if (isset($response['errcode']) && $response['errcode'] != 0) {
        $errorMsg = "错误码：{$response['errcode']}，错误信息：{$response['errmsg']}";
        throw new Exception($errorMsg);
    }
    return true;
}

七、安全性与性能优化

1. 接口安全：

验证请求来源是否为微信服务器（通过签名验证）
使用HTTPS协议传输数据
对用户输入进行过滤，防止XSS攻击

2. 性能优化：

缓存Access Token，减少重复请求
使用Curl替代file_get_contents提高请求效率
异步处理消息发送，避免阻塞主流程

Curl示例代码：

function curlPost($url, $data) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

八、完整案例：用户关注后自动回复

以下是一个完整案例：当用户关注公众号时，自动发送欢迎消息和图文菜单。

// 假设已获取用户的OpenID和事件类型
function handleFollowEvent($appId, $appSecret, $openId) {
    try {
        $accessToken = getAccessToken($appId, $appSecret);
        
        // 发送欢迎文本
        $textResult = sendTextMessage($accessToken, $openId, '感谢关注！');
        handleWeChatError($textResult);
        
        // 发送图文菜单
        $articles = [
            [
                'title' => '服务指南',
                'description' => '点击查看使用说明',
                'url' => 'https://example.com/guide',
                'picurl' => 'https://example.com/guide.jpg'
            ],
            [
                'title' => '联系我们',
                'description' => '客服在线时间：9:00-18:00',
                'url' => 'https://example.com/contact',
                'picurl' => 'https://example.com/contact.jpg'
            ]
        ];
        $newsResult = sendNewsMessage($accessToken, $openId, $articles);
        handleWeChatError($newsResult);
        
        return '消息发送成功';
    } catch (Exception $e) {
        return '消息发送失败：' . $e->getMessage();
    }
}

九、常见问题解答

Q1：为什么发送消息后用户收不到？

A1：检查以下原因：

Access Token是否有效
用户是否在48小时内与公众号有过互动（客服消息限制）
消息内容是否包含敏感词
接口调用频率是否超过限制

Q2：如何测试客服消息功能？

A2：可使用微信公众平台的“接口调试工具”进行测试，或通过“公众号测试号”模拟用户操作。

十、总结与扩展

通过本文的介绍，开发者可以掌握使用PHP实现微信公众号客服消息发送的核心技术。实际应用中，还可结合以下功能进行扩展：

消息模板：使用模板消息发送订单状态、支付通知等
菜单管理：动态生成自定义菜单
用户管理：获取用户基本信息、分组管理
素材管理：上传临时或永久素材

关键词：PHP、微信公众号、客服消息、Access Token、文本消息、图文消息、接口调试、错误处理、性能优化、Curl

简介：本文详细介绍了如何使用PHP实现微信公众号的客服消息发送功能，包括获取Access Token、发送文本和图文消息的代码实现、错误处理与调试方法、安全性与性能优化建议，以及一个完整的用户关注后自动回复案例。

立即下载

PHP相关