參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
grant_type | 是 | 獲取access_token填寫(xiě)client_credential |
appid | 是 | 第三方用戶(hù)唯一憑證 |
secret | 是 | 第三方用戶(hù)唯一憑證密鑰,即appsecret |
返回說(shuō)明
正常情況下,微信會(huì)返回下述JSON數(shù)據(jù)包給公眾號(hào):
{"access_token":"ACCESS_TOKEN","expires_in":7200}
參數(shù) | 說(shuō)明 |
---|---|
access_token | 獲取到的憑證 |
expires_in | 憑證有效時(shí)間,單位:秒 |
錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息,JSON數(shù)據(jù)包示例如下(該示例為AppID無(wú)效錯(cuò)誤):
{"errcode":40013,"errmsg":"invalid appid"}
例子:
獲取access_token:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credentialappid=wx41cb8dbd827a16e9secret=d4624c36b6795d1d99dcf0547af5443d
返回?cái)?shù)據(jù):
{ "access_token": "qR5UK2vMf5aTHV8e-uB10FZW0caTZm_1kbkUe4OPK2ILVvNaoa7pLzYWqLUAmx6Sjq1E7pKHrVAtuG0_1MPkqmDfOkm2750kaLWNk59DS-iDOpjjxompJtXa3WhbN5FKRWNhADAVAR", "expires_in": 7200 }
5、通過(guò)access_token群發(fā)短信
在公眾平臺(tái)網(wǎng)站上,為訂閱號(hào)提供了每天一條的群發(fā)權(quán)限,為服務(wù)號(hào)提供每月(自然月)4條的群發(fā)權(quán)限。而對(duì)于某些具備開(kāi)發(fā)能力的公眾號(hào)運(yùn)營(yíng)者,可以通過(guò)高級(jí)群發(fā)接口,實(shí)現(xiàn)更靈活的群發(fā)能力。
請(qǐng)注意:
1、對(duì)于認(rèn)證訂閱號(hào),群發(fā)接口每天可成功調(diào)用1次,此次群發(fā)可選擇發(fā)送給全部用戶(hù)或某個(gè)分組;
2、對(duì)于認(rèn)證服務(wù)號(hào)雖然開(kāi)發(fā)者使用高級(jí)群發(fā)接口的每日調(diào)用限制為100次,但是用戶(hù)每月只能接收4條,無(wú)論在公眾平臺(tái)網(wǎng)站上,還是使用接口群發(fā),用戶(hù)每月只能接收4條群發(fā)消息,多于4條的群發(fā)將對(duì)該用戶(hù)發(fā)送失敗;
3、具備微信支付權(quán)限的公眾號(hào),在使用群發(fā)接口上傳、群發(fā)圖文消息類(lèi)型時(shí),可使用a>標(biāo)簽加入外鏈;
4、開(kāi)發(fā)者可以使用預(yù)覽接口校對(duì)消息樣式和排版,通過(guò)預(yù)覽接口可發(fā)送編輯好的消息給指定用戶(hù)校驗(yàn)效果。
1)根據(jù)分組進(jìn)行群發(fā)【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】
調(diào)用接口:
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN
在body添加如下數(shù)據(jù)(以JSON格式數(shù)據(jù)發(fā)送)——發(fā)送其他格式數(shù)據(jù),只需要改里面參數(shù)信息即可,具體可查看微信官方文檔:
{ "filter":{ "is_to_all":false, "group_id":2 }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
參數(shù)說(shuō)明:
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
filter | 是 | 用于設(shè)定圖文消息的接收者 |
is_to_all | 否 | 用于設(shè)定是否向全部用戶(hù)發(fā)送,值為true或false,選擇true該消息群發(fā)給所有用戶(hù),選擇false可根據(jù)group_id發(fā)送給指定群組的用戶(hù) |
group_id | 否 | 群發(fā)到的分組的group_id,參加用戶(hù)管理中用戶(hù)分組接口,若is_to_all值為true,可不填寫(xiě)group_id |
mpnews | 是 | 用于設(shè)定即將發(fā)送的圖文消息 |
media_id | 是 | 用于群發(fā)的消息的media_id |
msgtype | 是 | 群發(fā)的消息類(lèi)型,圖文消息為mpnews,文本消息為text,語(yǔ)音為voice,音樂(lè)為music,圖片為image,視頻為video,卡券為wxcard |
title | 否 | 消息的標(biāo)題 |
description | 否 | 消息的描述 |
thumb_media_id | 是 | 視頻縮略圖的媒體ID |
例子:發(fā)送給所有人
url:
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=KBoNONaJZ4-KhafQVJoQ6VBX0F-bls7nAsJBn8Fy7GLwav4Be1lRJcob1RHH6wW35IxxFwkJnZfnc-On9EQITg3oxEWUw7O2YyVW9naDknu6PQX9fnSmQcr8ojTK8Ug-HDTcAAABXN
發(fā)送的json數(shù)據(jù):發(fā)送給所有人
{ "filter":{ "is_to_all":true }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
返回?cái)?shù)據(jù):
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 1000000003 }
參數(shù)意義:
參數(shù) | 說(shuō)明 |
---|---|
type | 媒體文件類(lèi)型,分別有圖片(image)、語(yǔ)音(voice)、視頻(video)和縮略圖(thumb),圖文消息為news |
errcode | 錯(cuò)誤碼 |
errmsg | 錯(cuò)誤信息 |
msg_id | 消息發(fā)送任務(wù)的ID |
msg_data_id | 消息的數(shù)據(jù)ID,該字段只有在群發(fā)圖文消息時(shí),才會(huì)出現(xiàn)??梢杂糜谠趫D文分析數(shù)據(jù)接口中,獲取到對(duì)應(yīng)的圖文消息的數(shù)據(jù),是圖文分析數(shù)據(jù)接口中的msgid字段中的前半部分,詳見(jiàn)圖文分析數(shù)據(jù)接口中的msgid字段的介紹。 |
錯(cuò)誤碼及其以及查詢(xún):
全局錯(cuò)誤碼解析
使用postman模擬https請(qǐng)求發(fā)送如下圖所示:
2)根據(jù)OpenID列表群發(fā)【訂閱號(hào)不可用,服務(wù)號(hào)認(rèn)證后可用】
發(fā)送的http請(qǐng)求url:(注意:和上面的不同)
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
數(shù)據(jù)格式:
{ "touser":[ "OPENID1", "OPENID2" ], "msgtype": "text", "text": { "content": "hello from boxer."} }
其中 OPENID1和OPENID2是我們要發(fā)送的微信用戶(hù)openId(用戶(hù)的唯一標(biāo)示)。
例子:
發(fā)送"oF3PcsnsrMiJzEwalZZbAfWQpxCI","oF3PcshH1CUIhR_WYau6swUiPzlw" 兩個(gè)用戶(hù)。
內(nèi)容為:hello from boxer.a href=‘www.baidu.com‘>歡迎來(lái)到百度/a>
url:
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=wRyTbnsiu18ssEhMPLf4bDfeT-Bt6e6tgR4CQGVLBipRcyJPkdAKPYfM6-qkKuHUN8uRKJh6Xvm0OuAdFgqOo8Ru8hoDxl-cGc9bh-ezJb2ZUcJSnQk2s416zI8kbEOfOGYdAFARJB
json數(shù)據(jù):
{ "touser":[ "oF3PcsnsrMiJzEwalZZbAfWQpxCI", "oF3PcshH1CUIhR_WYau6swUiPzlw" ], "msgtype": "text", "text": { "content": "hello from boxer.a href=‘http://www.seewoedu.com/‘>歡迎希沃學(xué)院/a>"} }
返回?cái)?shù)據(jù):
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 3147483654 }
使用postman模擬發(fā)送請(qǐng)求如下:
微信號(hào)接收到的內(nèi)容:
相關(guān)微信開(kāi)發(fā):
微信開(kāi)放平臺(tái)開(kāi)發(fā)——網(wǎng)頁(yè)微信掃碼登錄(OAuth2.0)
微信公眾平臺(tái)開(kāi)發(fā)——微信授權(quán)登錄(OAuth2.0)
致謝:感謝您的閱讀!
標(biāo)簽:黔南 桂林 東莞 南昌 宣城 景德鎮(zhèn) 文山 鹽城
巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《微信公眾平臺(tái)開(kāi)發(fā)——群發(fā)信息》,本文關(guān)鍵詞 微信,公眾,平臺(tái),開(kāi)發(fā),群發(fā),;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問(wèn)題,煩請(qǐng)?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無(wú)關(guān)。