WeHelp 接口规范

正常使用软件不会导致封号。

杀毒软件会对软件的正常运行构成影响，导致各种问题，请在使用前关闭杀毒软件。

接口介绍
接口服务端demo(python版)
消息回调接口
轮询消息接口
商务合作

接口介绍

一个软件开启一个微信程序，点击自定义接口，录入消息回调地址，轮询消息地址，点击立即保存，点击启动API即可。

消息回调地址：当 PC 微信有新事件产生，如收到新消息时，包括全部系统消息，都将通过该接口 post 消息到服务端。

轮询消息地址：可设置轮询时间间隔，定时轮询服务端是否有任务执行。

wechat多开，注意需要从客户端(WeHelp)唤起，一个客户端对应一个微信，对应一个processid。

接口服务端demo(python版)

https://github.com/juguang2018/wehelp

(demo的原理是开启httpServer服务,处理客户端(WeHelp)发送过来的的http请求，然后返回相应的respone)

一·消息回调

只要是 pc 微信接收到的消息都能收到，这个是客户端(WeHelp)主动推送给服务端的。

所有关于登录事件 type:67

数据格式示例:

{
"data":
    {
        "processid": 6072,
        "type": 67,
        "code": 200,
        "cwxid": "wxid_yfng437lnlygXXX"
    }
}

登录二维码 type:401

{
"data": 
    {
        "code": 401,
        "message": "XXXXXXXXXXXX"
    }
}

登录后获取个人信息或者其他的信息 type:71

{
"data":
    {
        "username": "yqxxxx",
        "processid": 6072,
        "type": 71,
        "cwxid": "wxid_yfng437lnlygXXX",
        "wxid": "wxid_yfng437lnlygXXX",
        "headPic": "http://wx.qlogo.cn/mmhead/ver_1/4wJLicLp7zzib6cfVlQUgYBcTQFOE/0",
        "sheadPic": "http://wx.qlogo.cn/mmhead/ver_1/4wJLid1cHOWY0p6ctcUgYBcTQFOE/132",
        "nick": "bigxxx",
        "asName": "",
        "province": "",
        "city": "",
        "sex": "2",
        "regionCode": "",
        "sign": ""
    }
}

初始化联系人列表 type:97

{
"data":{
    "cgi": "/cgi-bin/micromsg-bin/initcontact",
    "type": 97,
    "processid": 6072,
    "cwxid": "wxid_yfng437lnlygXXX",
    "packLen": 1805,
    "hex": "0A04080012001A6C76315F6533373965343937623666E676572",// 16进制的数据，包含所有联系人的wxid
    },
}

好友列表详细信息 type:210

"data":
{
    "type": 210,
    "processid": 8308,
    "cwxid": "wxid_sadaxxxxx",
    "userLists":
        [
            {
                "wxid": "gh_e456599aa7XXX",
                "asName": "(null)",
                "headPic":  "http://wx.qlogo.cn/mmhead/Q3auHgzwC6lpicvsSLj53d1Xe54w/0",
                "sheadPic": "http://wx.qlogo.cn/mmhead/Q3auHgz6lpicvsSLj53d1Xe54w/132",
                "nick": "微小强XXX",
                "username": "wsdXXX",
                "province": "上海",
                "city": "**",
                "sex": 0,
                "regionCode": "",
                "sign": "",
                "type": 3,
                "groupId": "None",
                "cwxid": "xxxxxxxx"
            }
        ]
}

获取群列表 type:211

{
"data":
    {
        "type": 211,
        "processid": 6072,
        "cwxid": "wxid_yfng437lnlygXXX",
        "chatrooms":
        [
            {"xml": "PD94bWwgdmVyc2lvbTHNWWk5LSIiIC8+",// base64 的 xml 格式数据，包括群昵称，群头像等
            "wxid": "82520287XXX@chatroom",
            "exist": true,
            "count": 56,
            "roomLord": false
            }
        ] 
    } 
}

获取群成员列表 type:77

{
"data":
    {
        "type":77,
        "processid":8844,
        "cwxid":"wxid_yfng437lnlygXXX",
        "wxid":"75101150XXX@chatroom",
        "info":"PD94bWwgdmVyc2lvbj0iMS4wIj8dDMWE3\r\naWE5SWJ1WDJkc3dLaWFVVlhIWjdZM0",
        "userLists":
        [
            {
                "wxid":"yly_11XXX",
                "headPic":"http://wx.qlogo.cnic5Kic1pMzgK30S8YY8iblHY0Qc/0",
                "sheadPic":"http://wx.qlogo.cn/mmhead/ver_1/XDXmlHY0Qc/132",
                "nick":"微小强xxx",
                "username":"",
                "asName":"",
                "province":"",
                "city":"",
                "sex":"2",
                "regionCode":"",
                "sign":""
            },
            {
                "wxid":"wxid_pigclv404o2iXXX",
                "headPic":"http://wx.qlogo.cn/mmhead/ver_1/dfnqH5NbvwHMEKU71HOVLiaVTw/0",
                "sheadPic":"http://wx.qlogo.cn/mmhead/ver_1/dfnSxxwHMEKU71HOVLiaVTw/132",
                "nick":"微大强xxx",
                "username":"bigxxx",
                "asName":"",
                "province":"",
                "city":"",
                "sex":"0",
                "regionCode":"",
                "sign":""
            }
        ]
    }
}

系统消息文本消息卡片消息视频消息图片消息群消息等等消息综合 type:78

数据格式示例:

{
    "type": 78,                     // int        信息分类，如接受消息，好友变动消息，群邀请信息等
    "msgType": "1",                 // string     信息类型，新好友（37）、系统消息（10000）、文本（1）、图片（3）
    "processid" : "7768",           // int        进程ID 
    "cwxid" : "wxid_adskjfseXXX",   // string     当前登录的微信号
    "wxid"  : "wxid_sadkwqlXXX",    // string     发送方的微信ID，如果发送方为群，怎为群ID
    "formWxid" :"wxid_sadkwqlkq",   // string     只有群消息才有，为发送方个人的微信ID
    "nick" : "XXXX",                // string     用户昵称，如果是群则为群昵称
    "message" : "XXXX",             // string     消息内容
}

网络获取联系人数据 type:88

{
"data":
    {
        "cgi":"/cgi-bin/micromsg-bin/getcontact",
        "type":88,
        "processid":6072,
        "cwxid":"wxid_yfng437lnlygXXX",
        "packLen":809,
        "hex":"0A040800120010011A99060A0B2040A0080038FFFFFFFF0",// 16进制数据,包含wxid、头像、v2等数据
    }
}

新建群后返回群id type:69

{
"data":
    {
        "type":69,
        "cwxid":"wxid_yfng437lnlygXXX",
        "xml":"",
        "chatroom":"218138553XXX@chatroom"
    }
}

同意好友 type:96

{
    "data":
    {
        "cgi":"/cgi-bin/micromsg-bin/verifyuser",
        "type":96,
        "processid":6072,
        "cwxid":"wxid_yfng437lnlyXXX",
        "packLen":6,
        "hex":"0A04080012001A6C76315F653839616E676572", // 返回16进制数据，先将数据转换为文本，如果包含 v1，则说明发送请求成功
    }
}

获取v2 type:81

{
"data":
    {
        "type":81,
        "processid":6072,
        "cwxid":"wxid_yfng437lnlyXXX",
        "wxid":"wxid_qg0saisth0rXXX",
        "v2":"v2_8a0384d4c6cb06add95851691b613d873b202311f358cc247c6891@stranger",
        "headPic":"http://wx.qlogo.cn/mmhead/ver_1/sD1PwMFiciclycKqvicF81uTEo/0",
        "sheadPic":"http://wx.qlogo.cn/mmhead/ver_1/sRAFiciclycKqvicF81uTEo/132",
        "nick":"DaQiXXX",
        "username":"e1030XXX",
        "asName":"",
        "province":"",
        "city":"上海",
        "sex":"1",
        "regionCode":"CN",
        "sign":""
    }
}

批量获取数据库微信头像 type:95

{
"data":
    {
        "type":95,
        "processid":8844,
        "cwxid":"wxid_yfng437lnlyXXX",
        "userLists":
        [
            {
            "wxid":"wxid_02p3fnfht9fXXX",
            "sheadPic":"http://wx.qlogo.cn/mmhead/ver_1/rShNJBqC5k16YicKw/132"
            },
            {
            "wxid":"wxid_ywoim7u92avXXX", 
            "sheadPic":"http://wx.qlogo.cn/mmhead/ver_1/VBibdtib6icj5JhUnib0/132"
            }
        ]
    }
}

退出微信事件 type:90

{
"data":{
    "cgi":"/cgi-bin/micromsg-bin/logout",
    "type":90,
    "processid":6072,
    "cwxid":"wxid_yfng437lnlyxxx",
    "packLen":6,
    "hex":"0A0408001200", // 16进制数据
    }
}

手机退出微信触发事件 type:98

{
"data":{
    "cgi":"/cgi-bin/micromsg-bin/autoauth",
    "type":98,
    "processid":6072,
    "cwxid":"wxid_yfng437lnlyxxx",
    "packLen":433,
    "hex":"0AAC02089CFFFFFFFFFF00280038001A0608001000280032020800", // 16进制数据
    }
}

二·轮询消息

该接口是服务端定时轮询客户端(WeHelp)来执行服务端发出的任务，轮询时间可以自己设置，默认时间单位为秒，以下所有接口中字段time为非必须，加time字段可以单独控制某个任务发送的延迟时间。

发送消息:

发送文本消息：数据格式:

{"api":"sendTextMessage", "code":1, "wxid":"wxid_qg0saisth0r2XXX", "text":"测试", "time":1}

2. 发送图片消息：数据格式:

{"api":"sendPicMessage", "code":2, "wxid":"wxid_asdasdXXX", "imgPath":"图片路径", "time":1}

3. 发送文件：数据格式:

{"api":"sendFileMessage", "code":25, "wxid":"wxid_asdasdXXX", "filePath":"文件路径", "time":1}

4. 发送xml消息数据格式:

{"api":"sendXmlMessage", "code":3, "wxid":"wxid_asdasdXXX", "title":"标题", "url":"url链接", "desc":"描述", "pic":"图片url链接", "time":1}

好友操作:

获取联系人：数据格式:

{"api":"initContact", "code":45}

2. 添加好友: 数据格式:

 {"api":"addUserEvent", "code":5, "wxid":"wxid_qg0saisth0r2XXX", "message":"您好"}

3. 删除好友: 数据格式:

 {"api":"delUser", "code":17, "wxid":"wxid_qg0saisth0r2XXX"}

4. 查询好友信息(一次最多五十人): 数据格式:

 {"api":"newGetUserLists", "code":46, "wxidLists":["wxid_qg0saisth0r2XXX", "asdad30XXX"]}

5. 获取好友信息: 数据格式：

{"api":"getUserInfo", "code":19, "wxid":"wxid_qg0saisth0r2XXX"}

6. 同意新好友数据格式：

{"api":"acceptFriend", "code":10, "v1":"xxx", "v2":"xxx"}

群操作:

获取所有群列表: 数据格式:

{"api":"getChatRoomLists", "code":47}

2. 修改群名称:

更新中

3. 踢群成员: 数据格式:

{"api":"delChatRoomUser", "code":12, "chatroom":"237230488XXX@chatroom", "wxid":"dasfada30XXX"}

4. 获取群成员列表: 数据格式:

{"api":"getChatRoomUserLists", "code":6, "wxid":"75101150XXX@chatroom"}

5. 修改群备注名称(我在本群的昵称) 数据格式:

{"api":"updateRoomAsName", "code":44, "chatroom":"237230488XXX@chatroom", "name":"修改群备注名称测试"}

6. 获取群成员v2然后就可以加好友数据格式：

{"api":"getRoomUserV2", "code":34, "chatroom":"75101150XXX@chatroom","wxid":"wxid_zxzs0isl4unhXXX"}

7. 群邀请数据格式：

{"api":"sendChatroom", "code":4, "wxid":"wxid_qg0saisth0r2XXX", "chatroom":"237230488XXX@chatroom"}

其他

获取登陆状态数据格式：

{"api":"getLoginStatus", "code":20,"info":"thisaaa"}

2. 网络获取wxid详细信息数据格式：

{"api":"netGetUserInfo", "code":30, "wxid":"xdasa30XXX"}

3. 登录二维码数据格式：

{"api":"getLoginQrCode", "code":36}

4. 退出登录微信数据格式：

{"api":"outLogin","code":39}

5. 批量获取wxid信息

更新中

6. 批量获取头像

更新中

iamstriker / wehelp

WeHelp 接口规范

接口介绍

接口服务端demo(python版)

一·消息回调

所有关于登录事件 type:67

登录二维码 type:401

登录后获取个人信息或者其他的信息 type:71

初始化联系人列表 type:97

好友列表详细信息 type:210

获取群列表 type:211

获取群成员列表 type:77

系统消息文本消息卡片消息视频消息图片消息群消息等等消息综合 type:78

网络获取联系人数据 type:88

新建群后返回群id type:69

同意好友 type:96

获取v2 type:81

批量获取数据库微信头像 type:95

退出微信事件 type:90

手机退出微信触发事件 type:98

二·轮询消息

发送消息:

好友操作:

群操作:

其他

商务合作

About

WeHelp 接口规范

接口介绍

接口服务端demo(python版)

一·消息回调

所有关于登录事件 type:67

登录二维码 type:401

登录后获取个人信息或者其他的信息 type:71

初始化联系人列表 type:97

好友列表详细信息 type:210

获取群列表 type:211

获取群成员列表 type:77

系统消息 文本消息 卡片消息 视频消息 图片消息 群消息 等等消息综合 type:78

网络获取联系人数据 type:88

新建群后返回群id type:69

同意好友 type:96

获取v2 type:81

批量获取数据库微信头像 type:95

退出微信事件 type:90

手机退出微信触发事件 type:98

二·轮询消息

发送消息:

好友操作:

群操作:

其他

商务合作

About

系统消息文本消息卡片消息视频消息图片消息群消息等等消息综合 type:78