微信公众平台开发（十） 消息回复总结

最新推荐文章于 2024-10-11 08:00:00 发布
最新推荐文章于 2024-10-11 08:00:00 发布
阅读量520 收藏
点赞数
分类专栏： 微信公众平台 文章标签： 微信 微信公众平台 微信公众平台开发 微信开发

微信公众平台开发（十） 消息回复总结

一、简介

微信公众平台提供了三种消息回复的格式，即文本回复、音乐回复和图文回复，在这一篇文章中，我们将对这三种消息回复的格式做一下简单讲解，然后封装成函数，以供读者使用。

二、思路分析

对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语音、视频、音乐）。

三、文本回复

3.1 文本回复xml 结构

复制代码 
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>
复制代码

3.2 结构说明

3.3 具体实施

针对上面给出的xml 结构，我们只需要在对应的位置填上内容，然后格式化输出就可以了。

说明：

ToUserName 位置上填写的是$fromUsername = $postObj->FromUserName，就是把消息返回给发送信息过来的用户，即接收方账号。

FromUserName 位置上填写的是$toUsername = $postObj->ToUserName，既是开发者微信号。

这是官方的文本回复，只需实例化它的responseMsg() 方法就可以回复 “Welcome to wechat world!” 消息了。

这里我们稍做修改，返回fromUsername 和toUsername 消息，便于读者理解以上的说明。

3.4 测试结果

3.5 封装成可调用的函数

我们可以将上面的内容封装成函数，在需要回复文本的地方直接调用，方便简洁，responseText.func.inc.php 代码如下。

复制代码 
function _response_text($object,$content){
    $textTpl = "<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[text]]></MsgType>
                <Content><![CDATA[%s]]></Content>
                <FuncFlag>%d</FuncFlag>
                </xml>";
    $resultStr = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content, $flag);
    return $resultStr;
}
复制代码

这样，只要传入$object 和$content，然后在需要回复文本的文件中引入该文件，然后调用 _response_text() 方法，就可以直接回复文本了。 

3.6 测试代码

3.6.1 在主文件中引入回复文本的函数文件

require_once 'responseText.func.inc.php';

3.6.2 普通消息回复

复制代码 
public function handleText($postObj)
    {
        $keyword = trim($postObj->Content);

        if(!empty( $keyword ))
        {
            $contentStr = "微信公众平台-文本回复功能源代码";
            //$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
            $resultStr = _response_text($postObj,$contentStr);
            echo $resultStr;
        }else{
            echo "Input something...";
        }
}
复制代码

3.6.3 关注时回复

复制代码 
public function handleEvent($object)
    {
        $contentStr = "";
        switch ($object->Event)
        {
            case "subscribe":
                $contentStr = "感谢您关注【卓锦苏州】"."\n"."微信号：zhuojinsz";
                break;
            default :
                $contentStr = "Unknow Event: ".$object->Event;
                break;
        }
        $resultStr = _response_text($object, $contentStr);
        return $resultStr;
}
复制代码

3.7 测试结果

回复文本成功。

四、图文回复

4.1 图文回复xml 结构

复制代码 
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <ArticleCount>2</ArticleCount>
 <Articles>
 <item>
 <Title><![CDATA[title1]]></Title> 
 <Description><![CDATA[description1]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 <item>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 </Articles>
 </xml>
复制代码

4.2 结构说明

类似文本回复的格式，只需要在相应的位置填上对应的内容就可以回复图文信息了。

4.3 具体实施

图文回复可以是单图文，也可以是多图文，这里我们先以单图文的案例来引导读者，然后再引出多图文。

我们将回复图文的xml 结构分解成为以下三个结构，图文头，图文体，图文尾，图文体就是图文回复时看到的标题，描述，图片URL和原文URL。

复制代码 
$newsTplHead = "<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[news]]></MsgType>
                <ArticleCount>1</ArticleCount>
                <Articles>";
$newsTplBody = "<item>
                <Title><![CDATA[%s]]></Title> 
                <Description><![CDATA[%s]]></Description>
                <PicUrl><![CDATA[%s]]></PicUrl>
                <Url><![CDATA[%s]]></Url>
                </item>";
$newsTplFoot = "</Articles>
                <FuncFlag>0</FuncFlag>
                </xml>";
复制代码

接下来，我们对三段结构分别插入对应内容：

A. $newsTplHead

$header = sprintf($newsTplHead, $object->FromUserName, $object->ToUserName, time());

B. $newsTplBody

$title = $newsContent['title'];
$desc = $newsContent['description'];
$picUrl = $newsContent['picUrl'];
$url = $newsContent['url'];
$body = sprintf($newsTplBody, $title, $desc, $picUrl, $url);

说明：$newsContent 是从主文件传入函数的图文数组。

C. $newsTplFoot

$FuncFlag = 0;
$footer = sprintf($newsTplFoot, $FuncFlag);

然后将三段进行拼接返回就可以回复单条图文了。

return $header.$body.$footer;

将以上内容写到一个函数里，命名为 _response_news() 函数，以供下面调用测试。

4.4 测试代码

4.4.1 在主文件中引入回复图文的函数文件

require_once 'responseNews.func.inc.php';

4.4.2 创建数组并传入

在主文件中，只需要向 _response_news() 函数中传入一个数组和$postObj 即可。

复制代码 
$record=array(
    'title' =>'山塘街',
    'description' =>'山塘街东起阊门渡僧桥，西至苏州名胜虎丘山的望山桥，长约七里，所以苏州俗语说“七里山塘到虎丘”...',
    'picUrl' => 'http://thinkshare.duapp.com/images/suzhou.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000046&itemidx=1&sign=9e7707d5615907d483df33ee449b378d#wechat_redirect'
);

$resultStr = _response_news($postObj,$record);
echo $resultStr;
复制代码

4.5 测试结果

点击进入查看

单图文回复测试成功。

4.6 多图文回复

有了上面的引导，读者应该能够想到回复多图文的思路了，就是将多维数组中的值循环放到相应的位置，然后拼接起来就可以了，下面进行讲解。 

4.6.1 获取图文条数

$bodyCount = count($newsContent);

4.6.2 判断图文条数

因为微信限制了回复的图文消息数为10条以内，所以需要判断图文条数，如果小于10条，则图文数等于原来的图文数，如果大于等于10条，则强制限制为10条。

$bodyCount = $bodyCount < 10 ? $bodyCount : 10;

4.6.3 组织图文体

图文头和图文尾和上面单图文一样，不再赘述，主要是图文体的组织。

用foreach 循环出数组的内容并赋予图文体，并进行拼接：

foreach($newsContent as $key => $value){
    $body .= sprintf($newsTplBody, $value['title'], $value['description'], $value['picUrl'], $value['url']);
}

说明：$newsContent 是从主文件传入函数的图文数组。

4.6.4 拼接并返回

return $header.$body.$footer;

将以上内容写到一个函数里，命名为 _response_multiNews() 函数，以供下面调用测试。

4.7 测试多图文

4.7.1 在主文件中引入回复多图文的函数文件

require_once 'responseMultiNews.func.inc.php';

4.7.2 创建多维数组并传入

复制代码 
$record[0]=array(
    'title' =>'观前街',
    'description' =>'观前街位于江苏苏州市区，是成街于清朝时期的百年商业老街，街上老店名店云集，名声远播海内外...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhou.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000052&itemidx=1&sign=90518631fd3e85dd1fde7f77c04e44d5#wechat_redirect'
);

......

$record[11]=array(
    'title' =>'平江路',
    'description' =>'平江路位于苏州古城东北，是一条傍河的小路，北接拙政园，南眺双塔，全长1606米，是苏州一条历史攸久的经典水巷。宋元时候苏州又名平江，以此名路...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhouScenic/pingjianglu.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000056&itemidx=1&sign=ef18a26ce78c247f3071fb553484d97a#wechat_redirect'
);

$resultStr = _response_multiNews($postObj,$record);
echo $resultStr;
复制代码

4.8 测试多图文结果

点击进入查看

测试多图文成功。

五、音乐回复

微信还提供了一种消息回复的格式，即音乐回复，下面我们编写程序测试一下。

注意：由于音乐版权的问题，现在很少有回复音乐的API，开放的API 查询出来的音乐信息也有很多是不正确的。所以在这里，我们上传几首音乐到自己的服务器空间测试。

本地文件：

测试是否能够正常播放：

5.1 音乐回复xml 结构

复制代码 
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>
复制代码

5.2 结构说明

5.3 具体实施

我们先做一个固定的歌曲回复来引导读者，然后再引出更高级别的歌曲查询回复。

5.3.1 在xml 结构的相应位置插入相应数据

复制代码 
<Music>
<Title><![CDATA[Far Away From Home]]></Title>
<Description><![CDATA[Groove Coverage]]></Description>
<MusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></MusicUrl>
<HQMusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></HQMusicUrl>
</Music>
复制代码

5.3.2 测试代码

$resultStr = _response_music($postObj,$keyword);
echo $resultStr;

5.3.3 测试结果

5.4 模拟点歌

有了上面的简单案例引导，读者应该可以想到模拟点歌的具体实现了吧，下面就来简单介绍一下。

思路：将歌曲代码和对应的歌曲名存入数据库，用户输入歌曲名，在数据库中找到歌曲名对应的歌曲编号，然后就可以生成MusicUrl 回复用户了。

5.4.1 创建数据库

建表语句及数据文件：

复制代码 
CREATE TABLE IF NOT EXISTS `tbl_music` (
  `music_id` int(11) NOT NULL,
  `music_name` varchar(40) NOT NULL,
  `music_singer` varchar(40) NOT NULL,
  `music_lrc` text NOT NULL,
  PRIMARY KEY (`music_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

INSERT INTO `tbl_music` (`music_id`, `music_name`, `music_singer`, `music_lrc`) VALUES
(10001, 'Far Away From Home', 'Groove Coverage', 'far away from home'),
(10002, 'The Dawn', 'Dreamtale', 'the dawn'),
(20002, '董小姐', '宋冬野', '董小姐'),
(20001, '左边', '杨丞琳', '左边');
复制代码

5.4.2 _response_music() 函数编写

A. 引入数据库操作文件

require_once('mysql_bae.func.php');

B. 数据库操作及数据处理

$query = "SELECT * FROM tbl_music WHERE music_name LIKE '%$musicKeyword%'";
$result = _select_data($query);
$rows = mysql_fetch_array($result, MYSQL_ASSOC);

$music_id = $rows[music_id];

注： $musicKeyword 为从主文件传入的歌曲名关键字，这里使用模糊查询，只取第一条数据。

C. 判断是否查询到

复制代码 
if($music_id <> '')
{
    $music_name = $rows[music_name];
    $music_singer = $rows[music_singer];
    $musicUrl = "http://thinkshare.duapp.com/music/".$music_id.".mp3";
    $HQmusicUrl = "http://thinkshare.duapp.com/music/".$music_id.".mp3";

    $resultStr = sprintf($musicTpl, $object->FromUserName, $object->ToUserName, time(), $music_name, $music_singer, $musicUrl, $HQmusicUrl);
    return $resultStr;
}else{
    return "";    
}
复制代码

说明：如果查询到歌曲信息，按照xml 结构返回数据；如果未查询到，则返回空，用于主文件判断。

将以上代码封装成 _response_music() 函数并保存为responseMusic.func.inc.php 文件供主文件调用。

5.4.3 测试代码

A. 引入回复音乐和回复文本的函数文件

//引入回复音乐的函数文件
require_once 'responseMusic.func.inc.php';
//引入回复文本的函数文件
require_once 'responseText.func.inc.php';

B. 调用

复制代码 
if(!empty( $keyword ))
{
    $resultStr = _response_music($postObj,$keyword);
    if($resultStr <> '')
    {
        echo $resultStr;
    }else
    {
        echo _response_text($postObj,"未查询到【".$keyword."】的歌曲信息！");    
    }
    
}
复制代码

说明：如果查询到歌曲信息，则返回所得信息，如果未查询到，则调用 _response_text() 函数返回文本信息。

5.5 模拟点歌测试

回复音乐测试成功。 

六、完整代码获取

请访问 乐思乐享 官方论坛

URL：http://pan.baidu.com/s/1c0s3Jby

七、关注

请关注 卓锦苏州 微信公众帐号，卓锦苏州 基于BAE 平台开发，针对于主流的微信功能进行开发测试。

您可以关注 卓锦苏州 公众帐号进行功能测试，以及获取新的应用开发。

1. 登录微信客户端，通讯录 -> 添加朋友 -> 查找公众号 -> zhuojinsz，查找并关注。

2. 扫描二维码：

卓锦苏州 功能列表：

 

Hist_花透
关注
专栏目录
微信公众平台 发送模板消息
小小布的程序世界
07-20 2万+
前言：最近一直再弄微信扫码推送图文消息和模板消息发送，感觉学习到了不少东西。今天先总结一下微信公众平台模板消息的发送。因为这个自己弄了很久，开始很多地方不明白，所以今天好好总结一下。微信公众平台技术文档：模板消息接口一、概述模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。关
微信公众平台开发-消息回复功能源代码
09-06
微信公众 平台开发 消息回复功 能源代码 单图文回复 多图文回复 文本回复 音乐回复 music 微信公众平台开发 多个功能整合
微信公众号开发----自动回复（第⑨篇）
最新发布
m0_64315223的博客
10-11 792
本期文章主要是讲微信公众号自动回复，功能成果如下，用户输入关键字，公众号会自动回复信息。跟着我的代码来就可以了，纯原生代码，只要配置能连接上，基本就没什么问题。首先还是得上微信公众平台。
微信XML消息model定义之微信公众平台(一)
weixin_33998125的博客
05-21 213
为什么80%的码农都做不了架构师？>>> ...
教程： nodejs 做微信公众号开发，回复 xml 消息
学习笔记
01-16 1439
首先需要你的后台跟服务器已经可以建立连接，这个不再冗述看官方教程就好。此篇介绍的是如何获取用户发来的信息，并回复它。
微信消息模板——巨坑
Aring的博客
02-02 551
微信平台分主动消息和被动消息，主动消息是生产服务器主动推送消息给微信平台，被动消息是用户行为导致微信平台推送消息给生产服务器。 主动消息需要： 1，将生产服务器ip加入ip白名单 2，然后根据appid和secret获取token 3，每次主动推送将token&在url上 被动消息： 1，填写生产服务器url路径在公众号配置上 2，获取token绑定 一、消息模板 1，获取微信消息模板api接口链接（巨坑，微信公众号文档上消息模板api链接有问题，正确应该在微信公众号，消
微信公众平台开发-消息回复功能源代码.rar_公众号_微信 公众号_微信公众号_微信公众号平台开发_微信消息
09-14
微信公众号平台开发的基础，利用它可以进行微信公众平台的开发
微信公众平台java开发完整项目示例程序源码---图灵机器人 微信智能回复
08-21
本例中列出了微信公众平台开发的所有流程的代码，包括接收xml数据、解析xml数据、调用图灵机器人api接口获取智能回复内容、封装结果xml数据等，简单明了，不明之处可查看个人博客中的讲解。
Java微信公众平台开发（5） 文本及图文消息回复的实现
08-30
主要为大家详细介绍了Java微信公众平台开发第五步，回文本及图文消息回复的实现代码，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
微信公众号-XML数据接收与处理
weixin_65375122的博客
02-26 694
微信开发-xml数据接收以及对应的参数逻辑编写
springboot实现微信模板消息推送
07-04
springboot实现微信模板消息推送，包含微信端代码。简单封装，方便二次开发！
Spring Boot 如何给微信公众号返回消息
2401_87167773的博客
09-18 923
大家注意这里消息类型的定义，以 RESP 开头的表示返回的消息类型，以 REQ 表示微信服务器发来的消息类型。其他的消息类型也是类似的定义，我就不一一列举了，至于其他消息的格式，大家可以参考微信开放文档（http://1t.click/aPXK）。在 Controller 中，我们首先判断消息是否是事件，如果是事件，进入到事件处理通道，如果不是事件，则进入到消息处理通道。这里我们还可以多加几个 elseif 去判断不同的消息类型，我这里因为只有普通文本消息，所以一个 if 就够用了。//公众号原始 ID。
微信公众号自动回复
jlbiubiu的博客
03-07 294
微信自动回复  只支持a标签和\n xml格式 记得转码 乱码会使得解析的时候 缺少结束标签
微信公众平台开发教程（二） 基本原理及消息接口总结
01-02
为了打消大家的顾虑，先简单介绍了微信公众平台的基本原理。 微信服务器就相当于一个转发服务器，终端（手机、Pad等）发起请求至微信服务器，微信服务器，然后将请求转发给自定义服务（这就里就是我们的具体实现）。...
java解析通讯录xml_企业微信通讯录回调 成员回调 （新增成员和编辑成员）xml解析错误...
weixin_29015127的博客
02-27 670
提问前，请确保阅读过项目首页说明以及wiki开发文档相关内容，尤其是常见问题部分。完成内容后，请务必移除包括本句在内的无用内容，以免影响阅读，否则直接关闭，谢谢合作~另外如果确认属于bug，而且已明确如何修复，请参考贡献指南直接提交PR，省的浪费时间在这里描述问题，非常感谢配合简要描述简单概括描述下你所遇到的问题。企业微信通讯录回调 成员回调 (新增成员和编辑成员)xml解析错误模块版本情况WxJ...
【微信公众号开发】三、解析微信事件XML数据消息及响应
MicroAnswer的博客
07-11 5761
文章详情：【微信公众号开发】三、解析微信事件XML数据消息及响应 链接：https://www.microanswer.cn/blog/13
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值