開發和搭建前所需(仔細必看到頭)
注意!微信公衆號必須爲服務號(即不是在訂閱號文件夾裏的那種的,而是直接類似一個微信用戶那種),同時需要微信認證(絕對要認證)
1:需要管理員在微信公衆平臺登錄(登錄主管理員賬號,或者聯繫主管理員讓其登錄進行)給予開發者:運營者(小管理員)權限
2:查看 開發-基本設置中:其中id和secret要記住(沒有就新設置,有千萬別重置),有了這倆才能用接口換token值進行開發
3:修改IP白名單,在已有的基礎上新增自己的,http://ip.qq.com/可以查看自己IP,這樣開發時調用接口纔不會被屏蔽
4:!!!!重點,如果想要調用客服功能(即通過公衆號給某個人發送消息),還需要在功能中開通客服功能才行!
在你之前就已經開通、創建的,可以直接去看 已知信息 了,當然,最好還是接着看。
沒開通的,開通完畢後,不會有客服,需要你自己主動創建一個客服(例如我們創建·文控雲小助手)
創建完畢後編輯,上傳頭像
然後綁定主管理者的微信
!注意,上面的必須做!沒有客服賬號,無法調用發消息接口。
雖然調用接口也可以創建客服,修改客服,但是能手動的不要去打代碼!(因爲懶)
好了,現在,可以進行開發或者調用接口了~
已知需要收集的信息(可能不全)
微信接口開發文檔:
微信公衆號(服務號):XXXX
微信公衆號賬號:XXXXX
微信公衆號密碼:XXXX
開發者ID(AppID):XXXXX
開發者密碼(AppSecret):XXXXX
開發第一步
目前已知問題解決的方式
1:access_token因爲太長,如果被複制到別的地方可能會多出空格(比如txt中)
因此,如果access_token調用接口時返回錯誤問題,賦值後一定要查看
access_token中間是否是沒有空格的(有的話刪除,複製到txt中一般會多2個)
2:接口基本都有調用次數,請節省使用,尤其是access_token接口,只有2000次,
如果不清楚具體次數,就要上微信公衆平臺看。
3:用戶信息只能查找到userid和微信暱稱,不能知道用戶的真實姓名
解決辦法,在原項目數據庫中添加一條wxId,然後根據暱稱查詢到微信的id添加到原項目的wxid中,每次發消息調用原數據庫的wxid。
4:首先我得申明一下:如果只是單純的發送信息,如果關注公衆號的用戶不是活躍用戶(即1天或者很好長時間沒有看過公衆號)那麼發送信息的接口將會調用失敗,並返回一個錯誤,需要用戶和公衆號說一句話才行
解決的辦法是:使用模板消息接口進行信息發送
前端對接注意
要與後端多功能
Postman-Eg
假如我們的token是:
15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL:
-------------------查詢從開頭是10000名用戶-----------------------
https://api.weixin.qq.com/cgi-bin/user/get?
access_token=15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-
KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL&next_openid
=
{
"total": 1, 關注該公衆賬號的總用戶數
"count": 1, 拉取的OPENID個數,最大值爲10000
"data": { 列表數據,OPENID的列表
"openid": [
"odrKA1jUSSXZyfAcRfxVHp_RzA8g"
]
},
"next_openid": "odrKA1jUSSXZyfAcRfxVHp_RzA8g" 拉取列表的最後一個用戶的OPENID
}
-----------------根據id獲取用戶信息---------------------------------------------------
https://api.weixin.qq.com/cgi-bin/user/info?
access_token=15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-
KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL&openid=odrK
A1jUSSXZyfAcRfxVHp_RzA8g&lang=zh_CN
{
"subscribe": 1,
"openid": "odrKA1jUSSXZyfAcRfxVHp_RzA8g",
"nickname": "老白的小跟班",
"sex": 1,
"language": "zh_CN",
"city": "哈爾濱",
"province": "黑龍江",
"country": "中國",
"headimgurl":
"http://thirdwx.qlogo.cn/mmopen/4hJDDPYJRchbMbGdtdL4ZfxmvN5M7okibaQ2MTnjLTllnBH2ibq0QLzUj40Nza4tQBEwhJt
a2rHwnZmDTTbIuQJmrHmIIWOo5f/132",
"subscribe_time": 1541041913,
"remark": "",
"groupid": 0,
"tagid_list": [ ],
"subscribe_scene": "ADD_SCENE_SEARCH",
"qr_scene": 0,
"qr_scene_str": ""
}
--------------------獲取客服-------------------------------------------------------
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?
access_token=15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-
KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL
{
"kf_list": [
{
"kf_account": "test1@test",
"kf_headimgurl": "",
"kf_id": 2001,
"kf_nick": "文控雲小助手"
}
]
}
--------------------創建一個新的--------------------------------------------------------------
https://api.weixin.qq.com/customservice/kfaccount/add?
access_token=15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-
KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL
{
"kf_account" : "test1@test",
"nickname" : "文控雲小助手",
"password" : "123456"
}
{
"errcode": 0,
"errmsg": "ok"
}
------------------------發消息-------------------------------------------------------------
https://api.weixin.qq.com/cgi-bin/message/custom/send?
access_token=15_C1TWfhMJh6v_EgF2GdU667b6j1a4BiSS8RwZwBFiBLHrqr5HDjt0FTWk3e9SOJ-
KY3F8lv6Q0WIAv6fOLFhCTny8DBSSWMYDUXoDran4OlCgVvSYsgMa7n2cWqOoU8RAdIp4Wajc766KGaGOFXAhAEAQIL
{
"touser":"odrKA1jUSSXZyfAcRfxVHp_RzA8g",
"msgtype":"text",
"text":
{
"content":"你好啊!"
}
}
{
"errcode": 0,
"errmsg": "ok"
}