PHP微信高级接口调用方法

自定义菜单接口

步骤一：定义菜单结构

在使用自定义菜单接口之前，我们必须先定义一个菜单的结构，例如：

{
    "button": [
        {
            "name": "菜单1",
            "sub_button": [
                {
                    "type": "view",
                    "name": "菜单1-1",
                    "url": "http://example.com/"
                },
                {
                    "type": "click",
                    "name": "菜单1-2",
                    "key": "MENU_1_2"
                }
            ]
        },
        {
            "name": "菜单2",
            "type": "view",
            "url": "http://example.org/"
        }
    ]
}

步骤二：使用接口创建菜单

定义好菜单结构之后，我们可以使用 WeChatAPI 类来发送接口请求，从而创建自定义菜单：

<?php
require_once 'WeChatAPI.php';

$api = new WeChatAPI();
$menu = '...'; // 定义好的菜单结构
$result = $api->create_menu($menu);

if ($result->errmsg === 'ok') {
    echo '自定义菜单创建成功';
} else {
    echo '自定义菜单创建失败：' . $result->errmsg;
}

客服接口

客服接口可以让我们在开发公众号时，使用客服账号与用户进行实时交互，例如发送文字消息、图片消息，或者回复用户的问题。

我们可以使用 WeChatAPI 类提供的接口来管理客服账号，例如：

步骤一：添加客服账号

<?php
require_once 'WeChatAPI.php';

$api = new WeChatAPI();
$kf_account = 'test@test';
$kf_nick = '客服昵称';
$result = $api->add_kf_account($kf_account, $kf_nick);

if ($result->errmsg === 'ok') {
    echo '客服账号添加成功';
} else {
    echo '客服账号添加失败：' . $result->errmsg;
}

步骤二：发送消息

<?php
require_once 'WeChatAPI.php';

$api = new WeChatAPI();
$to_user = 'user_openid';
$msg_type = 'text';
$content = '测试消息';
$result = $api->send_kf_message($to_user, $msg_type, $content);

if ($result->errmsg === 'ok') {
    echo '消息发送成功';
} else {
    echo '消息发送失败：' . $result->errmsg;
}

二维码接口

使用二维码接口，我们可以生成带参数的二维码图片，这样用户可以通过扫描二维码来识别场景和参数。

步骤一：创建临时二维码

<?php
require_once 'WeChatAPI.php';

$api = new WeChatAPI();
$expire_seconds = 3600; // 二维码有效时间，单位为秒
$action_name = 'QR_SCENE'; // 临时二维码类型
$scene_id = 1234; // 场景值ID，根据业务需求定义
$result = $api->create_qr_code($expire_seconds, $action_name, $scene_id);

if ($result->ticket) {
    $qr_code_url = $api->get_qr_code_url($result->ticket);
    echo '<img src="' . $qr_code_url . '" />';
} else {
    echo '二维码生成失败：' . $result->errmsg;
}

步骤二：创建永久二维码

<?php
require_once 'WeChatAPI.php';

$api = new WeChatAPI();
$action_name = 'QR_LIMIT_SCENE'; // 永久二维码类型
$scene_id = 1234; // 场景值ID，根据业务需求定义
$result = $api->create_qr_code($expire_seconds, $action_name, $scene_id);

if ($result->ticket) {
    $qr_code_url = $api->get_qr_code_url($result->ticket);
    echo '<img src="' . $qr_code_url . '" />';
} else {
    echo '二维码生成失败：' . $result->errmsg;
}