微群管家 HttpApi接口文档

7. [高级接口] 主动触发

接口功能

软件每隔指定周期（自定义）,请求url地址(POST方式),返回规定的消息格式, 可以给好友/群内自动回复内容. (可以发文字,文章,图片,视屏,音乐,名片,文件,小程序)

URL

填写的url地址 (即自己的服务器url)

接收地址 : 支持 IP ( http://123.123.123.123/ ) , 域名 ( http://www.yourname.com/ ) , 本地 Localhost ( http://localhost/ )

HTTP请求方式

POST

接收到的参数

参数中文名称说明

robotid 机器人唯一 ID 扫码机器人的唯一 ID

robotnickname 机器人昵称已经转码为：Unicode编码，格式”\u“，需要在服务器解码

参数	中文名称	说明
robotid	机器人唯一 ID	扫码机器人的唯一 ID
robotnickname	机器人昵称	已经转码为：Unicode编码，格式”\u“，需要在服务器解码

接口返回 - 待发消息格式 ( 严格按格式返回，非json )

返回参数返回值描述

rs 1 正常触发消息（群/好友）
返回例子： {"rs":1,"tip":"这里是返回的内容,可以为空","wxid":"wxid_123123","end":0}

rs 10 获取当前群所有成员，软件会再调一次接口
(发送所有群成员参数 "memberlist"，status=9退群,1正常)，不会处理返回值
返回例子： {"rs":10,"wxid":"123123@chatroom","end":0}

rs 11 加群成员为好友
返回例子： {"rs":11,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}

rs 12 发送进群邀请链接
返回例子： {"rs":12,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}

rs 13 将指定群的成员，踢出本群
返回例子： {"rs":13,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}

rs 15 修改群名
返回例子(改群名) ： {"rs":15,"chatroom":"123123@chatroom","nickname":"这里是新群的名字","end":0}
返回例子(改好友备注) ： {"rs":15,"wxid":"wxid_123123","nickname":"这里是好友的备注","end":0}

rs 15 获取好友与群列表数据 (与上面的区别: 不返回参数nickname即可)
POST参数: grouplist(群列表), friendlist(好友列表) .
注: 昵称可能带特殊符号,有可能导致json转换失败(不要直接转json),建议直接正则或循环取具体数据 (多测试)
返回例子： {"rs":15,"end":0}

rs 16 退出群 (wxid为要退的群)
返回例子： {"rs":16,"wxid":"123123@chatroom","end":0}

返回值格式说明（严格按格式返回，非json）：

1. 返回多个消息, 可以自己组合：
{"rs":1,"tip":"这里是返回的内容，utf-8格式中文，不需要转码[结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img][结束][img]http://www.dijiu.com/upload/2009/2/24/2009022479639361.gif[/img]","wxid":"wxid_123123","end":0}

2. 重要: 返回参数 tip 有内容, 将会发到参数 wxid 指定的ID对象

返回参数	返回值	描述
rs	1	正常触发消息（群/好友）返回例子： {"rs":1,"tip":"这里是返回的内容,可以为空","wxid":"wxid_123123","end":0}
rs	10	获取当前群所有成员，软件会再调一次接口 (发送所有群成员参数 "memberlist"，status=9退群,1正常)，不会处理返回值返回例子： {"rs":10,"wxid":"123123@chatroom","end":0}
rs	11	加群成员为好友返回例子： {"rs":11,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}
rs	12	发送进群邀请链接返回例子： {"rs":12,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}
rs	13	将指定群的成员，踢出本群返回例子： {"rs":13,"chatroom":"123123@chatroom","wxid":"wxid_123123","end":0}
rs	15	修改群名返回例子(改群名) ： {"rs":15,"chatroom":"123123@chatroom","nickname":"这里是新群的名字","end":0} 返回例子(改好友备注) ： {"rs":15,"wxid":"wxid_123123","nickname":"这里是好友的备注","end":0}
rs	15	获取好友与群列表数据 (与上面的区别: 不返回参数nickname即可) POST参数: grouplist(群列表), friendlist(好友列表) . 注: 昵称可能带特殊符号,有可能导致json转换失败(不要直接转json),建议直接正则或循环取具体数据 (多测试) 返回例子： {"rs":15,"end":0}
rs	16	退出群 (wxid为要退的群) 返回例子： {"rs":16,"wxid":"123123@chatroom","end":0}

Unicode解码函数-php版（建议php版本5.4, 过高有可能不支持）

function unicode_decode($str) {
    //Unicode解码 linux UCS-2BE，windows UCS-2LE
    $t = preg_replace("#\\\u([0-9a-f]{4})#ie", "iconv('UCS-2BE', 'UTF-8', pack('H4', '\\1'))", $str);
    return $t;
}

Unicode解码函数-php版（建议php版本高于5.4）

function unicode_decode($str) {
    return preg_replace_callback('/\\\\u([0-9a-f]{4})/i',
        create_function(
            '$matches',
            'return mb_convert_encoding(pack("H*", $matches[1]), "UTF-8", "UCS-2BE");'
        ),
    $str);
}

可发送特殊格式:

1：网络图片：[结束][img]https://www.baidu.com/img/baidu_jgylogo3.gif[/img]

2：本地图片：[结束][localimg]D:\demo.jpg[/localimg]

3：发文章：[结束][url][title=百度],[des=百度一下],[url=http://www.baidu.com/],[img=https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png][/url]

4：发小程序：[结束][app][title=标题],[appnickname=小程序名称],[pagepath=小程序路径],[username=gh_xxxxxxx@app],[img=缩略图本地路径][/app]
【重要】必须pcwx2.7.1.82版及以上支持
小程序路径（可不填），具体内容在收到小程序后，软件日志中获取 <pagepath>小程序路径</pagepath>
gh_xxxxxxx@app（必填），具体内容在收到小程序后，软件日志中获取 <username>gh_xxxxxxx@app</username>

5：发名片：[结束][card]好友微信号,好友昵称[/card]

6：发视频：[结束][file]D:\demo.mp4[/file]

7：发文件：[结束][file]本地文件路径[/file]

8：发音乐：[结束][music][title=这里填写标题],[des=这里是描述],[url=这里是点击打开网址],[musicurl=这里是音频文件网址][/music]

9：@某人：#@wxid_xxx# 内容@ （1.多个wxid用英文逗号; 2.[内容]中必须包含@, 只要@多少个成员, 内容中就必须包含多少个@符号，可以在任意位置）

10：发公告：[notice]公告内容[/notice] （注: 机器人必须是群主）

11：图片+文字：这里是返回的内容[结束]这里是第二条消息[结束][img]https://www.baidu.com/logo.gif[/img][结束][img]https://www.baidu.com/logo.gif[/img][结束]分割

12：多条消息：用 [结束] 分割

13：随机消息：用 | 符号

14：随机代码：[随机表情] , [随机字母]