微群管家 HttpApi接口文档

3. [群] 主动消息接口 (定时消息)

接口功能

软件每2分钟,请求接收地址(POST方式),然后,接收地址返回规定的消息格式, 可以在群里自动回复内容. (可以发文字,文章,图片,视屏,音乐,名片,文件)

注: 发文章,图片,视屏,音乐,名片,文件, 需要开通高级服务

URL

创建应用时填写的接收地址 (即自己的服务器url)

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

HTTP请求方式

POST

接收到的参数

参数中文名称说明

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

gid 群唯一 ID 应用市场群ID

gusername 群唯一ID 微信群ID

skw 应用 ID 创建应用的唯一 ID

参数	中文名称	说明
robotid	机器人唯一 ID	扫码机器人的唯一 ID
gid	群唯一 ID	应用市场群ID
gusername	群唯一ID	微信群ID
skw	应用 ID	创建应用的唯一 ID

接口返回 - 待发消息格式 ( 严格按格式返回字符串, 顺序不能乱，非json )

返回参数返回值描述

rs 1 正常触发消息

rs 14 将返回的群成员昵称/wxid，踢出本群。（注: 机器人必须是群主才能踢人）（附加参数："nickname"）
返回例子： {"rs":14,"tip":"这里是返回的内容","wxid":"群成员微信id","end":0}

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

格式一，普通回复（直接回复发消息对象）：
{"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]","end":0}

返回参数	返回值	描述
rs	1	正常触发消息
rs	14	将返回的群成员昵称/wxid，踢出本群。（注: 机器人必须是群主才能踢人）（附加参数："nickname"）返回例子： {"rs":14,"tip":"这里是返回的内容","wxid":"群成员微信id","end":0}

可发送特殊格式:

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>

图片路径失效, 可以用以下格式: [结束][app][appid=不知道可忽略],[title=标题],[appnickname=小程序名称],[username=gh_xxxxxxx@app],[cdnthumburl=xxxx],[cdnthumbaeskey=xxxx][/app]
cdnthumburl 与 cdnthumbaeskey 参数通过机器人接收图片日志, 可以查到

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：随机代码：[随机表情] , [随机字母]