WeChat APIのWebバージョン(WeChatのターミナルバージョンとWeChatロボットを含む)
サンプル スクリプトが適切に実行されることを確認するには、必要なサードパーティ パッケージをインストールしてください。
pip install -r requirements.txt
注: 以下に示す画像と機能は最新のものではない可能性があります。詳細についてはソース コードを参照してください。
指示に従って携帯電話の WeChat で QR コードをスキャンし、ログインします。自動応答モードをオンにするかどうかを選択できます。
自動返信モードをオンにすると、受信したテキストメッセージがテキストメッセージの場合、グループメッセージも含めて自動的に返信されます。
名刺、リンク、アニメーション絵文字、住所の場所のメッセージ。
基本的にWeb版の機能は全てサポートされております。
+--------------+ +---------------+ +---------------+
| | | | | |
| Get UUID | | Get Contact | | Status Notify |
| | | | | |
+-------+------+ +-------^-------+ +-------^-------+
| | |
| +-------+ +--------+
| | |
+-------v------+ +-----+--+------+ +--------------+
| | | | | |
| Get QRCode | | Weixin Init +------> Sync Check <----+
| | | | | | |
+-------+------+ +-------^-------+ +-------+------+ |
| | | |
| | +-----------+
| | |
+-------v------+ +-------+--------+ +-------v-------+
| | Confirm Login | | | |
+------> Login +---------------> New Login Page | | Weixin Sync |
| | | | | | |
| +------+-------+ +----------------+ +---------------+
| |
|QRCode Scaned|
+-------------+
API | UUIDを取得する |
---|---|
URL | https://login.weixin.qq.com/jslogin |
方法 | 役職 |
データ | URLエンコード |
パラメータ | appid :应用ID fun : 新しい 应用类型 lang : zh_CN 语言 _ : 时间戳 |
戻りデータ (文字列):
window.QRLogin.code = 200; window.QRLogin.uuid = "xxx"
注: ここでの appid は、WeChat オープン プラットフォームに登録されているアプリケーションの AppID です。 WeChat の Web バージョンには 2 つの AppID があり、初期のものは
wx782c26e4c19acffb
で、アプリケーション名は WeChat クライアント上でWeb微信
として表示され、現在のものはwxeb7ec651dd0aefa9
で、表示名は微信网页版
です。
API | バインドログイン (webwxpushloginurl) |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxpushloginurl |
方法 | 得る |
パラメータ | ういん:xxx |
戻りデータ (文字列):
{'msg': 'all ok', 'uuid': 'xxx', 'ret': '0'}
通过这种方式可以省掉扫二维码这步操作,更加方便
API | QRコードを生成する |
---|---|
URL | uuid |
方法 | 得る |
API | QRコードをスキャンしてログインします |
---|---|
URL | https://login.weixin.qq.com/cgi-bin/mmwebwx-bin/login |
方法 | 得る |
パラメータ | ヒント: 1未扫描 0已扫描 uuid :xxx _ : 时间戳 |
戻りデータ (文字列):
window.code=xxx;
xxx:
408 登陆超时
201 扫描成功
200 确认登录
当返回200时,还会有
window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=xxx&uuid=xxx&lang=xxx&scan=xxx";
API | webwx新しいログインページ |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage |
方法 | 得る |
パラメータ | チケット:xxx uuid :xxx lang : zh_CN 语言 スキャン:xxx 楽しい:新しい |
戻りデータ (XML):
<error>
<ret>0</ret>
<message>OK</message>
<skey>xxx</skey>
<wxsid>xxx</wxsid>
<wxuin>xxx</wxuin>
<pass_ticket>xxx</pass_ticket>
<isgrayscale>1</isgrayscale>
</error>
API | webwxinit |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit?pass_ticket=xxx&skey=xxx&r=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { ウイン:xxx、 シド:xxx、 スキー:xxx、 デバイスID:xxx、 } } |
戻りデータ (JSON):
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"Count": 11,
"ContactList": [...],
"SyncKey": {
"Count": 4,
"List": [
{
"Key": 1,
"Val": 635705559
},
...
]
},
"User": {
"Uin": xxx,
"UserName": xxx,
"NickName": xxx,
"HeadImgUrl": xxx,
"RemarkName": "",
"PYInitial": "",
"PYQuanPin": "",
"RemarkPYInitial": "",
"RemarkPYQuanPin": "",
"HideInputBarFlag": 0,
"StarFriend": 0,
"Sex": 1,
"Signature": "Apt-get install B",
"AppAccountFlag": 0,
"VerifyFlag": 0,
"ContactFlag": 0,
"WebWxPluginSwitch": 0,
"HeadImgFlag": 1,
"SnsFlag": 17
},
"ChatSet": xxx,
"SKey": xxx,
"ClientVersion": 369297683,
"SystemTime": 1453124908,
"GrayScale": 1,
"InviteStartCount": 40,
"MPSubscribeMsgCount": 2,
"MPSubscribeMsgList": [...],
"ClickReportInterval": 600000
}
API | webwxstatus通知 |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxstatusnotify?lang=zh_CN&pass_ticket=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 コード: 3、 FromUserName: 自己ID 、ToUserName: 自己ID 、ClientMsgId: 时间戳 } |
戻りデータ (JSON):
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
...
}
API | webwxgetcontact |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin//webwxgetcontact?pass_ticket=xxx&skey=xxx&r=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
戻りデータ (JSON):
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
"MemberCount": 334,
"MemberList": [
{
"Uin": 0,
"UserName": xxx,
"NickName": "Urinx",
"HeadImgUrl": xxx,
"ContactFlag": 3,
"MemberCount": 0,
"MemberList": [],
"RemarkName": "",
"HideInputBarFlag": 0,
"Sex": 0,
"Signature": "你好,我们是地球三体组织。在这里,你将感受到不一样的思维模式,以及颠覆常规的世界观。而我们的目标,就是以三体人的智慧,引领人类未来科学技术500年。",
"VerifyFlag": 8,
"OwnerUin": 0,
"PYInitial": "URINX",
"PYQuanPin": "Urinx",
"RemarkPYInitial": "",
"RemarkPYQuanPin": "",
"StarFriend": 0,
"AppAccountFlag": 0,
"Statues": 0,
"AttrStatus": 0,
"Province": "",
"City": "",
"Alias": "Urinxs",
"SnsFlag": 0,
"UniFriend": 0,
"DisplayName": "",
"ChatRoomId": 0,
"KeyWord": "gh_",
"EncryChatRoomId": ""
},
...
],
"Seq": 0
}
API | webwxbatchgetcontact |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxbatchgetcontact?type=ex&r=xxx&pass_ticket=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 カウント: 群数量 、リスト: [ { ユーザー名: 群ID 、 EncryChatRoomId: "" }、... ]、 } |
返却データ(JSON)は上記と同じ
API | 同期チェック |
---|---|
プロトコル | https |
ホスト | webpush.weixin.qq.com webpush.wx2.qq.com webpush.wx8.qq.com webpush.wx.qq.com webpush.web2.wechat.com webpush.web.wechat.com |
パス | /cgi-bin/mmwebwx-bin/synccheck |
方法 | 得る |
データ | URLエンコード |
パラメータ | r :时间戳 シド:xxx ういん:xxx スキー:xxx デバイスID :xxx 同期キー:xxx _ : 时间戳 |
戻りデータ (文字列):
window.synccheck={retcode:"xxx",selector:"xxx"}
retcode:
0 正常
1100 失败/登出微信
selector:
0 正常
2 新的消息
7 进入/离开聊天界面
API | webwxsync |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync?sid=xxx&skey=xxx&pass_ticket=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 同期キー: xxx、 rr: 时间戳取反 } |
戻りデータ (JSON):
{
'BaseResponse': {'ErrMsg': '', 'Ret': 0},
'SyncKey': {
'Count': 7,
'List': [
{'Val': 636214192, 'Key': 1},
...
]
},
'ContinueFlag': 0,
'AddMsgCount': 1,
'AddMsgList': [
{
'FromUserName': '',
'PlayLength': 0,
'RecommendInfo': {...},
'Content': "",
'StatusNotifyUserName': '',
'StatusNotifyCode': 5,
'Status': 3,
'VoiceLength': 0,
'ToUserName': '',
'ForwardFlag': 0,
'AppMsgType': 0,
'AppInfo': {'Type': 0, 'AppID': ''},
'Url': '',
'ImgStatus': 1,
'MsgType': 51,
'ImgHeight': 0,
'MediaId': '',
'FileName': '',
'FileSize': '',
...
},
...
],
'ModChatRoomMemberCount': 0,
'ModContactList': [],
'DelContactList': [],
'ModChatRoomMemberList': [],
'DelContactCount': 0,
...
}
API | webwxsendmsg |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg?pass_ticket=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 メッセージ: { タイプ: 1 文字消息 、内容: 要发送的消息 、FromUserName: 自己ID 、ToUserName: 好友ID 、LocalID: 与clientMsgId相同 、ClientMsgId: 时间戳左移4位随后补上4位随机数 } } |
戻りデータ (JSON):
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
},
...
}
API | webwxrevokemsg |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxrevokemsg |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 SvrMsgId: msg_id、 ToUserName: user_id、 ClientMsgId: local_msg_id } |
戻りデータ (JSON):
{
"BaseResponse": {
"Ret": 0,
"ErrMsg": ""
}
}
API | webwxsendmsgemotion |
---|---|
URL | https://wx2.qq.com/cgi-bin/mmwebwx-bin/webwxsendomoticon?fun=sys&f=json&pass_ticket=xxx |
方法 | 役職 |
データ | JSON |
ヘッダ | ContentType: アプリケーション/json 文字セット=UTF-8; |
パラメータ | { BaseRequest: { Uin: xxx、Sid: xxx、Skey: xxx、DeviceID: xxx }、 メッセージ: { タイプ: 47 個の emoji消息 、絵文字フラグ: 2、 MediaId: 表情上传后的媒体ID 、FromUserName: 自己ID 、ToUserName: 好友ID 、LocalID: 与clientMsgId相同 、ClientMsgId: 时间戳左移4位随后补上4位随机数 } } |
API | ウェブサイトゲティコン |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgeticon |
方法 | 得る |
パラメータ | seq :数字,可为空 ユーザー名: ID スキー:xxx |
API | webwxgetheadimg |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetheadimg |
方法 | 得る |
パラメータ | seq :数字,可为空 ユーザー名: 群ID スキー:xxx |
API | webwxgetmsgimg |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetmsgimg |
方法 | 得る |
パラメータ | MsgID :消息ID type : スレーブ 略缩图 、または为空时加载原图 スキー:xxx |
API | webwxgetvideo |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvideo |
方法 | 得る |
パラメータ | msgstr :消息ID スキー:xxx |
API | webwxgetvoice |
---|---|
URL | https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxgetvoice |
方法 | 得る |
パラメータ | msgstr :消息ID スキー:xxx |
タイプ | 説明する |
---|---|
個人アカウント | @ で始まります (例: @xxx |
グループチャット | @@ で始まります (例: @@xxx |
パブリックアカウント/サービスアカウント | @ で始まりますが、 VerifyFlag & 8 != 0 があります。VerifyFlag :一般個人パブリックアカウント/サービスアカウント:8 一般企業サービス番号:24 WeChat公式アカウント 微信团队 :56名 |
特別口座 | ファイル転送アシスタントなどのアカウントには特別な ID があります。現在知られているものは次のとおりです。filehelper 、 newsapp 、 fmessage 、 weibo 、 qqmail 、 tmessage 、 qmessage 、 qqsync 、 floatbottle 、 lbsapp 、 shakeapp 、 medianote 、 qqfriend 、 readerapp 、 blogapp 、 facebookapp 、 masssendapp 、 meishiapp 、 feedsapp 、 voip 、 blogappweixin 、 weixin 、 brandsessionholder 、 weixinreminder 、 officialaccounts 、 notification_messages 、 wxitil 、 userexperience_alarm 、 notification_messages |
メッセージの一般的な形式:
{
"FromUserName": "",
"ToUserName": "",
"Content": "",
"StatusNotifyUserName": "",
"ImgWidth": 0,
"PlayLength": 0,
"RecommendInfo": {...},
"StatusNotifyCode": 4,
"NewMsgId": "",
"Status": 3,
"VoiceLength": 0,
"ForwardFlag": 0,
"AppMsgType": 0,
"Ticket": "",
"AppInfo": {...},
"Url": "",
"ImgStatus": 1,
"MsgType": 1,
"ImgHeight": 0,
"MediaId": "",
"MsgId": "",
"FileName": "",
"HasProductId": 0,
"FileSize": "",
"CreateTime": 1454602196,
"SubMsgType": 0
}
メッセージタイプ | 説明する |
---|---|
1 | テキストメッセージ |
3 | 絵メッセージ |
34 | 音声メッセージ |
37 | 友達確認メッセージ |
40 | 可能性のあるEND_MSG |
42 | 名刺を共有する |
43 | ビデオメッセージ |
47 | アニメーション顔文字 |
48 | 位置メッセージ |
49 | リンクを共有する |
50 | VOIPMSG |
51 | WeChat初期化メッセージ |
52 | 音声通知 |
53 | ヴォイピンバイト |
62 | 短いビデオ |
9999 | シスノティス |
10000 | システムメッセージ |
10002 | メッセージの撤回 |
WeChat初期化メッセージ
MsgType: 51
FromUserName: 自己ID
ToUserName: 自己ID
StatusNotifyUserName: 最近联系的联系人ID
Content:
< msg >
< op id =' 4 ' >
< username >
// 最近联系的联系人
filehelper,xxx@chatroom,wxid_xxx,xxx,...
</ username >
< unreadchatlist >
< chat >
< username >
// 朋友圈
MomentsUnreadMsgStatus
</ username >
< lastreadtime >
1454502365
</ lastreadtime >
</ chat >
</ unreadchatlist >
< unreadfunctionlist >
// 未读的功能账号消息,群发助手,漂流瓶等
</ unreadfunctionlist >
</ op >
</ msg >
テキストメッセージ
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: 消息内容
絵メッセージ
MsgType: 3
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取图片
Content:
< msg >
< img length =" 6503 " hdlength =" 0 " />
< commenturl > </ commenturl >
</ msg >
小さなビデオメッセージ
MsgType: 62
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取小视频
Content:
< msg >
< img length =" 6503 " hdlength =" 0 " />
< commenturl > </ commenturl >
</ msg >
地理位置情報メッセージ
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx
// 属于文本消息,只不过内容是一个跳转到地图的链接
名刺メッセージ
MsgType: 42
FromUserName: 发送方ID
ToUserName: 接收方ID
Content :
< ? xml version = "1.0" ? >
< msg bigheadimgurl = "" smallheadimgurl = "" username = "" nickname = "" shortpy = "" alias = "" imagestatus = "3" scene = "17" province = "" city = "" sign = "" sex = "1" certflag = "0" certinfo = "" brandIconUrl = "" brandHomeUrl = "" brandSubscriptConfigUrl = "" brandFlags = "0" regionCode = "" />
RecommendInfo:
{
"UserName" : "xxx" , // ID
"Province" : "xxx" ,
"City" : "xxx" ,
"Scene" : 17 ,
"QQNum" : 0 ,
"Content" : "" ,
"Alias" : "xxx" , // 微信号
"OpCode" : 0 ,
"Signature" : "" ,
"Ticket" : "" ,
"Sex" : 0 , // 1:男, 2:女
"NickName" : "xxx" , // 昵称
"AttrStatus" : 4293221 ,
"VerifyFlag" : 0
}
音声メッセージ
MsgType: 34
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取语音
Content:
< msg >
< voicemsg endflag =" 1 " cancelflag =" 0 " forwardflag =" 0 " voiceformat =" 4 " voicelength =" 1580 " length =" 2026 " bufid =" 216825389722501519 " clientmsgid =" 49efec63a9774a65a932a4e5fcd4e923filehelper174_1454602489 " fromusername ="" />
</ msg >
アニメーション顔文字
MsgType: 47
FromUserName: 发送方ID
ToUserName: 接收方ID
Content:
< msg >
< emoji fromusername = "" tousername = "" type =" 2 " idbuffer =" media:0_0 " md5 =" e68363487d8f0519c4e1047de403b2e7 " len = " 86235 " productid =" com.tencent.xin.emoticon.bilibili " androidmd5 =" e68363487d8f0519c4e1047de403b2e7 " androidlen =" 86235 " s60v3md5 = " e68363487d8f0519c4e1047de403b2e7 " s60v3len =" 86235 " s60v5md5 = " e68363487d8f0519c4e1047de403b2e7 " s60v5len =" 86235 " cdnurl = " http://emoji.qpic.cn/wx_emoji/eFygWtxcoMF8M0oCCsksMA0gplXAFQNpiaqsmOicbXl1OC4Tyx18SGsQ/ " designerid = "" thumburl = " http://mmbiz.qpic.cn/mmemoticon/dx4Y70y9XctRJf6tKsy7FwWosxd4DAtItSfhKS0Czr56A70p8U5O8g/0 " encrypturl = " http://emoji.qpic.cn/wx_emoji/UyYVK8GMlq5VnJ56a4GkKHAiaC266Y0me0KtW6JN2FAZcXiaFKccRevA/ " aeskey = " a911cc2ec96ddb781b5ca85d24143642 " > </ emoji >
< gameext type =" 0 " content =" 0 " > </ gameext >
</ msg >
通常のリンクまたはアプリケーション共有メッセージ
MsgType: 49
AppMsgType: 5
FromUserName: 发送方ID
ToUserName: 接收方ID
Url: 链接地址
FileName: 链接标题
Content:
< msg >
< appmsg appid ="" sdkver =" 0 " >
< title > </ title >
< des > </ des >
< type > 5 </ type >
< content > </ content >
< url > </ url >
< thumburl > </ thumburl >
...
</ appmsg >
< appinfo >
< version > </ version >
< appname > </ appname >
</ appinfo >
</ msg >
音楽リンクメッセージ
MsgType: 49
AppMsgType: 3
FromUserName: 发送方ID
ToUserName: 接收方ID
Url: 链接地址
FileName: 音乐名
AppInfo: // 分享链接的应用
{
Type: 0,
AppID: wx485a97c844086dc9
}
Content:
< msg >
< appmsg appid =" wx485a97c844086dc9 " sdkver =" 0 " >
< title > </ title >
< des > </ des >
< action > </ action >
< type > 3 </ type >
< showtype > 0 </ showtype >
< mediatagname > </ mediatagname >
< messageext > </ messageext >
< messageaction > </ messageaction >
< content > </ content >
< contentattr > 0 </ contentattr >
< url > </ url >
< lowurl > </ lowurl >
< dataurl >
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
</ dataurl >
< lowdataurl >
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
</ lowdataurl >
< appattach >
< totallen > 0 </ totallen >
< attachid > </ attachid >
< emoticonmd5 > </ emoticonmd5 >
< fileext > </ fileext >
</ appattach >
< extinfo > </ extinfo >
< sourceusername > </ sourceusername >
< sourcedisplayname > </ sourcedisplayname >
< commenturl > </ commenturl >
< thumburl >
http://imgcache.qq.com/music/photo/album/63/180_albumpic_143163_0.jpg
</ thumburl >
< md5 > </ md5 >
</ appmsg >
< fromusername > </ fromusername >
< scene > 0 </ scene >
< appinfo >
< version > 29 </ version >
< appname >摇一摇搜歌</ appname >
</ appinfo >
< commenturl > </ commenturl >
</ msg >
グループメッセージ
MsgType: 1
FromUserName: @@xxx
ToUserName: @xxx
Content:
@xxx:<br/>xxx
赤い封筒のニュース
MsgType: 49
AppMsgType: 2001
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: 未知
注: Web バージョンのコードによると、将来的には赤い封筒メッセージの表示をサポートする可能性があることがわかりますが、現在はシステム メッセージを使用しています。以下を参照してください。
システムメッセージ
MsgType: 10000
FromUserName: 发送方ID
ToUserName: 自己ID
Content:
"你已添加了 xxx ,现在可以开始聊天了。"
"如果陌生人主动添加你为朋友,请谨慎核实对方身份。"
"收到红包,请在手机上查看"
WeixinBot の他の開発者とコミュニケーションを取りたい場合、または質問や提案がある場合は、WeChat グループ [犬に餌を与えた青年] に参加して議論してください。下の QR コードをスキャンしてロボットを友達として追加し、[Aidog] に返信してグループに参加するためのリンクを取得します。
注: これはグループの QR コードではありません。ロボットがあなたをグループに引き込みますので、必ずロボット [Aidog] に返信してください (秘密のコード: Aidog)。