服务号消息提醒

在浏览某个云课堂的时候,发现了一个直播提醒的功能。在点击开启提醒后,发现它走了如下流程:

  1. 点击开启提醒,弹出一个公众号二维码
  2. 微信扫描二维码,进入小程序客服(app流程)
  3. 点击发送右小角的小程序卡片(app流程)
  4. 服务器返回公众号二维码图片(app流程)
  5. 点击图片识别二维码,关注公众号

云课堂的PC端的开启提醒很简单,只需要扫描二维码即可,但是在 app 开启提醒就稍微复杂了点。
虽然不容易,但经过一番折腾后,终于走通了整个直播提醒的功能。 现分享给需要的朋友。

以下是 app 直播提醒功能:

生成待带参数的二维码

据我所知,目前关注公众号有两种方式:

  1. 扫描或识别公众号后台生成的二维码
  2. 扫描或识别带参数的二维码

这两种都属于关注事件,但第二种在用户关注公众号后,会将带场景值的扫描事件推送给开发者。我们利用这个场景值,可带额外的参数传递给应用服务器,开发者可根据这些参数来判断用户是否已开启提醒。
所以,我们用生成带参数的二维码来完成扫码关注。

生成带参数的二维码地址

下面我们来创建临时二维码:

  1. 获取 access token
$client = new \GuzzleHttp\Client(['verify' => false]);
$header['content-type'] = 'application/json; charset=UTF-8';

$param = [
    'appid' => 'appId',             // 公众号的 appid
    'secret' => 'appSecret',        // 公众号的 secret 
    'grant_type' => 'client_credential'
];

$url = 'https://api.weixin.qq.com/cgi-bin/token?' . http_build_query($param);
$result = file_get_contents($url);
$result = \GuzzleHttp\json_decode($result, true);

if (isset($result['errcode']) && $result['errcode'] <> 0) {
    throw new WeChatException('获取 access_token 失败', 500);
}

$accessToken = $result['access_token'];

2.根据 access_token 获取 ticket

// app传递的数据
$data = [
    'live_id' => 10,    // 直播 ID
    'user_id' => 5      // 用户 ID,未登录可传递 0
];

// post 数据格式
$tmp = [
    'expire_seconds' => 5 * 60,
    'action_name' => 'QR_STR_SCENE',
    'action_info' => [
        'scene' => [
            'scene_str' => http_build_query($data)
        ]
    ]
];
$url = 'https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=' . $accessToken;
$json = \GuzzleHttp\json_encode($data, 256);
$ticket = $this->post($url, $json, ['headers' => $headers])['ticket';

3.根据 ticket 生成二维码图片

拿到 ticket 后,访问下面的链接,打开的是一个公众号二维码图片。云课堂的 PC 端即是用这种方式

$qCodeUrl = 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=urlencode('.$ticket.')';

唤起小程序

在 app 中,当点击 开启提醒 时,因为要跳转到小程序客服,所以我们需要将公众号与小程序进行关联。

关联步骤:登录公众号 -> 小程序 -> 管理小程序 -> 添加
关联完成后,就可以在 app 中唤起小程序了。

这个步骤需要 app 开发者和前端开发者协同开发
app 跳转到小程序时,同样要传递直播 ID 和 用户 ID。

小程序推送客服消息

客服消息地址

类似公众号推送消息,小程序同样也可以推送该消息。
当用户想微信服务器发送小程序卡片时,
判断 当msgtype 的值为 miniprogrampage 时,发送回复消息

1.获取 Access toten
小程序获取 access token 和公众号获取 access token 基本相同,不同的是 appid和secret分别要换成小程序的 appid 和 secret

$client = new \GuzzleHttp\Client(['verify' => false]);
$header['content-type'] = 'application/json; charset=UTF-8';

$param = [
    'appid' => 'appId',             // 小程序的 appid
    'secret' => 'appSecret',        // 小程序的 secret 
    'grant_type' => 'client_credential'
];

$url = 'https://api.weixin.qq.com/cgi-bin/token?' . http_build_query($param);
$result = file_get_contents($url);
$result = \GuzzleHttp\json_decode($result, true);

if (isset($result['errcode']) && $result['errcode'] <> 0) {
    throw new WeChatException('获取 access_token 失败', 500);
}

$accessToken = $result['access_token'];
  1. 发送图文消息

我们在第二步中已经生成了公众号二维码,可以直接拿来用

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

$tmp = [
    'touser' => 'OPENID',          // 用户发送卡片时会有个 FromUserName 字段,即 openid
    'msgtype' => "link",
    'link' => [
        'title' => '直播提醒',
        "description" => "点击识别二维码",
        'url' => $qrCodeUrl,            // 带参数的二维码地址
        'thumb_url' => '小程序跳转地址'
    ]
];

$client = new \GuzzleHttp\Client(['verify' => false]);
$header['content-type'] = 'application/json; charset=UTF-8';

$response = $client->request('POST', $url, [
    'headers' => $header,
    'body' => \GuzzleHttp\json_encode($data, 256),
]);

return \GuzzleHttp\json_decode((string)$response->getBody(), true);

图文消息识别二维码

由于推送二维码图片时,需要Media_id,比较麻烦,所以在小程序中,我将公众号二维码地址做成了图文消息发送给用户,
用户点击图文消息后,会显示二维码,用户识别二维码后,即可关注公众号

保存提醒信息

关注公众号,要做个提示消息,告诉用户已经 开启提醒成功。
刚好生成带参数的二维码可以帮助我们。

扫描带参数二维码事件有两种情况:

  1. 用户未关注时,进行关注后事件消息:
<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
  <EventKey><![CDATA[qrscene_123123]]></EventKey>
  <Ticket><![CDATA[TICKET]]></Ticket>
</xml>
  1. 用户已关注时的事件消息:
<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[SCAN]]></Event>
  <EventKey><![CDATA[SCENE_VALUE]]></EventKey>
  <Ticket><![CDATA[TICKET]]></Ticket>
</xml> 

第一种情况,我们可以根据 EventKey 来判断是否是扫描带参数的二维码;
第二种情况,我们可以根据 Event 来判断是否是扫描带参数的二维码;

所以,当出现以上两种情况时,我们就可以判定,用户开启了直播提醒。记录用户的 openid, 以便给用户推送提醒消息

申请模板消息

略

以上既是 app 开启直播提醒的流程。
需要注意的点:

  1. 公众号必须是服务号
  2. 公众号必须关联小程序
  3. app 唤起小程序时必须传递参数

评论

暂无评论