目录

5. [友/群] 主动消息接口(任意) ( [友/群]定时消息 )


接口功能

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

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

URL

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

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

HTTP请求方式

POST

接收到的参数
参数 中文名称 说明
robotid 机器人唯一 ID 扫码机器人的唯一 ID
robotnickname 机器人昵称 已经转码为:Unicode编码,格式”\u“,需要在服务器解码
skw 应用 ID 创建应用的唯一 ID
接口返回 - 待发消息格式 ( 严格按格式返回,非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对象

可发送特殊格式:

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