微信公眾平臺(tái)高級(jí)群發(fā)功能接口

珠海微信營(yíng)銷網(wǎng)：微信官方公眾平臺(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ā)能力。

【微信公眾號(hào)群發(fā)圖文消息的過(guò)程如下】：

1、首先，預(yù)先將圖文消息中需要用到的圖片，使用上傳圖文消息內(nèi)圖片接口，上傳成功并獲得圖片URL；

2、上傳圖文消息素材，需要用到圖片時(shí)，請(qǐng)使用上一步獲取的圖片URL；

3、使用對(duì)用戶分組的群發(fā)，或?qū)penID列表的群發(fā)，將圖文消息群發(fā)出去；

4、在上述過(guò)程中，如果需要，還可以預(yù)覽圖文消息、查詢?nèi)喊l(fā)狀態(tài)，或刪除已群發(fā)的消息等。

【關(guān)于微信公眾號(hào)群發(fā)時(shí)使用is_to_all為true使其進(jìn)入公眾號(hào)在微信客戶端的歷史消息列表】：

1、使用is_to_all為true且成功群發(fā)，會(huì)使得此次群發(fā)進(jìn)入歷史消息列表。

2、為防止異常，認(rèn)證訂閱號(hào)在一天內(nèi)，只能使用is_to_all為true進(jìn)行群發(fā)一次，或者在公眾平臺(tái)官網(wǎng)群發(fā)（不管本次群發(fā)是對(duì)全體還是對(duì)某個(gè)分組）一次。以避免一天內(nèi)有2條群發(fā)進(jìn)入歷史消息列表。

3、類似地，服務(wù)號(hào)在一個(gè)月內(nèi)，使用is_to_all為true群發(fā)的次數(shù)，加上公眾平臺(tái)官網(wǎng)群發(fā)（不管本次群發(fā)是對(duì)全體還是對(duì)某個(gè)分組）的次數(shù)，最多只能是4次。

4、設(shè)置is_to_all為false時(shí)是可以多次群發(fā)的，但每個(gè)用戶只會(huì)收到最多4條，且這些群發(fā)不會(huì)進(jìn)入歷史消息列表。

【微信公眾號(hào)群發(fā)圖片、文本等其他消息類型的過(guò)程如下】：

1、如果是群發(fā)文本消息，則直接根據(jù)下面的接口說(shuō)明進(jìn)行群發(fā)即可；

2、如果是群發(fā)圖片、視頻等消息，則需要預(yù)先通過(guò)素材管理接口準(zhǔn)備好mediaID；

【微信官方提醒第三方接口開(kāi)發(fā)商注意】：

1、對(duì)于認(rèn)證訂閱號(hào)，群發(fā)接口每天可成功調(diào)用1次，此次群發(fā)可選擇發(fā)送給全部用戶或某個(gè)分組；

2、對(duì)于認(rèn)證服務(wù)號(hào)雖然開(kāi)發(fā)者使用高級(jí)群發(fā)接口的每日調(diào)用限制為100次，但是用戶每月只能接收4條，無(wú)論在公眾平臺(tái)網(wǎng)站上，還是使用接口群發(fā)，用戶每月只能接收4條群發(fā)消息，多于4條的群發(fā)將對(duì)該用戶發(fā)送失敗；

3、具備微信支付權(quán)限的公眾號(hào)，在使用群發(fā)接口上傳、群發(fā)圖文消息類型時(shí)，可使用<a>標(biāo)簽加入外鏈；

4、開(kāi)發(fā)者可以使用預(yù)覽接口校對(duì)消息樣式和排版，通過(guò)預(yù)覽接口可發(fā)送編輯好的消息給指定用戶校驗(yàn)效果。

【以下是微信公眾平臺(tái)高級(jí)群發(fā)功能接口代碼-來(lái)源于微信官方網(wǎng)站】

上傳圖文消息內(nèi)的圖片獲取URL【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

請(qǐng)注意，本接口所上傳的圖片不占用公眾號(hào)的素材庫(kù)中圖片數(shù)量的5000個(gè)的限制。圖片僅支持jpg/png格式，大小必須在1MB以下。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN 調(diào)用示例（使用curl命令，用FORM表單方式上傳一個(gè)圖片）：
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"

參數(shù)說(shuō)明

返回說(shuō)明 正常情況下的返回結(jié)果為：

{
    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}

其中url就是上傳圖片的URL，可用于后續(xù)群發(fā)中，放置到圖文消息中。

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息。

上傳圖文消息素材【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

{
   "articles": [
		 {
                        "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
                        "author":"xxx",
			 "title":"Happy Day",
			 "content_source_url":"www.qq.com",
			 "content":"content",
			 "digest":"digest",
                        "show_cover_pic":"1"
		 },
		 {
                        "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
                        "author":"xxx",
			 "title":"Happy Day",
			 "content_source_url":"www.qq.com",
			 "content":"content",
			 "digest":"digest",
                        "show_cover_pic":"0"
		 }
   ]
}

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
   "type":"news",
   "media_id":"CsEf3ldqkAYJAU6EJeIkStVDSvffUJ54vqbThMgplD-VJXXof6ctX5fI6-aYyUiQ",
   "created_at":1391857799
}

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息。

根據(jù)分組進(jìn)行群發(fā)【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

圖文消息（注意圖文消息的media_id需要通過(guò)上述方法來(lái)得到）：

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"
}

文本：

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
   "text":{
      "content":"CONTENT"
   },
    "msgtype":"text"
}

語(yǔ)音（注意此處media_id需通過(guò)基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
   "voice":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"voice"
}

圖片（注意此處media_id需通過(guò)基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
   "image":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"image"
}

視頻

請(qǐng)注意，此處視頻的media_id需通過(guò)POST請(qǐng)求到下述接口特別地得到：https://file.api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST數(shù)據(jù)如下（此處media_id需通過(guò)基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：

{
  "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
  "title": "TITLE",
  "description": "Description"
}

返回將為

{
  "type":"video",
  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
  "created_at":1398848981
}

然后，POST下述數(shù)據(jù)（將media_id改為上一步中得到的media_id），即可進(jìn)行發(fā)送

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
   "mpvideo":{
      "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
   },
    "msgtype":"mpvideo"
}

卡券消息（注意圖文消息的media_id需要通過(guò)上述方法來(lái)得到）：

{
   "filter":{
      "is_to_all":false
      "group_id":"2"
   },
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"         
            },
   "msgtype":"wxcard"
}

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182, 
   "msg_data_id": 206227730
}

請(qǐng)注意：在返回成功時(shí)，意味著群發(fā)任務(wù)提交成功，并不意味著此時(shí)群發(fā)已經(jīng)結(jié)束，所以，仍有可能在后續(xù)的發(fā)送過(guò)程中出現(xiàn)異常情況導(dǎo)致用戶未收到消息，如消息有時(shí)會(huì)進(jìn)行審核、服務(wù)器不穩(wěn)定等。此外，群發(fā)任務(wù)一般需要較長(zhǎng)的時(shí)間才能全部發(fā)送完畢，請(qǐng)耐心等待。

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息、

根據(jù)OpenID列表群發(fā)【訂閱號(hào)不可用，服務(wù)號(hào)認(rèn)證后可用】

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

圖文消息（注意圖文消息的media_id需要通過(guò)上述方法來(lái)得到）：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"
}

文本：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
    "msgtype": "text",
    "text": { "content": "hello from boxer."}
}

語(yǔ)音：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "voice":{
      "media_id":"mLxl6paC7z2Tl-NJT64yzJve8T9c8u9K2x-Ai6Ujd4lIH9IBuF6-2r66mamn_gIT"
   },
    "msgtype":"voice"
}

圖片：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "image":{
      "media_id":"BTgN0opcW3Y5zV_ZebbsD3NFKRWf6cb7OPswPi9Q83fOJHK2P67dzxn11Cp7THat"
   },
    "msgtype":"image"
}

視頻：

請(qǐng)注意，此處視頻的media_id需通過(guò)POST請(qǐng)求到下述接口特別地得到： https://api.weixin.qq.com/cgi-bin/media/uploadvideo?access_token=ACCESS_TOKEN POST數(shù)據(jù)如下（此處media_id需通過(guò)基礎(chǔ)支持中的上傳下載多媒體文件來(lái)得到）：

{
  "media_id": "rF4UdIMfYK3efUfyoddYRMU50zMiRmmt_l0kszupYh_SzrcW5Gaheq05p_lHuOTQ",
  "title": "TITLE",
  "description": "Description"
}

返回將為

{
  "type":"video",
  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",
  "created_at":1398848981
}

然后，POST下述數(shù)據(jù)（將media_id改為上一步中得到的media_id），即可進(jìn)行發(fā)送

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "video":{
      "media_id":"123dsdajkasd231jhksad",
      "title":"TITLE",
      "description":"DESCRIPTION"
   },
    "msgtype":"video"
}

卡券：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
        "wxcard": {"card_id":"123dsdajkasd231jhksad"}
        "msgtype":"wxcard"
}

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
   "errcode":0,
   "errmsg":"send job submission success",
   "msg_id":34182, 
   "msg_data_id": 206227730
}

請(qǐng)注意：在返回成功時(shí)，意味著群發(fā)任務(wù)提交成功，并不意味著此時(shí)群發(fā)已經(jīng)結(jié)束，所以，仍有可能在后續(xù)的發(fā)送過(guò)程中出現(xiàn)異常情況導(dǎo)致用戶未收到消息，如消息有時(shí)會(huì)進(jìn)行審核、服務(wù)器不穩(wěn)定等。此外，群發(fā)任務(wù)一般需要較長(zhǎng)的時(shí)間才能全部發(fā)送完畢，請(qǐng)耐心等待。

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息。

刪除群發(fā)【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/delete?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

{
   "msg_id":30124
}

請(qǐng)注意：

1、只有已經(jīng)發(fā)送成功的消息才能刪除
2、刪除消息是將消息的圖文詳情頁(yè)失效，已經(jīng)收到的用戶，還是能在其本地看到消息卡片。
3、刪除群發(fā)消息只能刪除圖文消息和視頻消息，其他類型的消息一經(jīng)發(fā)送，無(wú)法刪除。
4、如果多次群發(fā)發(fā)送的是一個(gè)圖文消息，那么刪除其中一次群發(fā)，就會(huì)刪除掉這個(gè)圖文消息也，導(dǎo)致所有群發(fā)都失效

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
   "errcode":0,
   "errmsg":"ok"
}

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，請(qǐng)根據(jù)錯(cuò)誤碼查詢錯(cuò)誤信息。

預(yù)覽接口【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

開(kāi)發(fā)者可通過(guò)該接口發(fā)送消息給指定用戶，在手機(jī)端查看消息的樣式和排版。為了滿足第三方平臺(tái)開(kāi)發(fā)者的需求，在保留對(duì)openID預(yù)覽能力的同時(shí)，增加了對(duì)指定微信號(hào)發(fā)送預(yù)覽的能力，但該能力每日調(diào)用次數(shù)有限制（100次），請(qǐng)勿濫用。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

圖文消息（其中media_id與根據(jù)分組群發(fā)中的media_id相同）：

{
   "touser":"OPENID", 
   "mpnews":{              
            "media_id":"123dsdajkasd231jhksad"               
             },
   "msgtype":"mpnews" 
}

文本：

{     
    "touser":"OPENID",
    "text":{           
           "content":"CONTENT"            
           },     
    "msgtype":"text"
}

語(yǔ)音（其中media_id與根據(jù)分組群發(fā)中的media_id相同）：

{
    "touser":"OPENID",
    "voice":{              
            "media_id":"123dsdajkasd231jhksad"
            },
    "msgtype":"voice" 
}

圖片（其中media_id與根據(jù)分組群發(fā)中的media_id相同）：

{
    "touser":"OPENID",
    "image":{      
            "media_id":"123dsdajkasd231jhksad"
            },
    "msgtype":"image" 
}

視頻（其中media_id與根據(jù)分組群發(fā)中的media_id相同）：

{
    "touser":"OPENID",
    "mpvideo":{  "media_id":"IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc",   
               },
    "msgtype":"mpvideo" 
}

卡券：

{ "touser":"OPENID", 
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad",
            "card_ext": "{\"code\":\"\",\"openid\":\"\",\"timestamp\":\"1402057159\",\"signature\":\"017bb17407c8e0058a66d72dcc61632b70f511ad\"}"               
            }, 
  "msgtype":"wxcard" 
}

請(qǐng)注意，上述JSON數(shù)據(jù)中的touser字段都可以改為towxname，這樣就可以針對(duì)微信號(hào)進(jìn)行預(yù)覽（而非openID），towxname和touser同時(shí)賦值時(shí)，以towxname優(yōu)先。修改后JSON數(shù)據(jù)如下（以圖文消息為例）： 圖文消息：

{
   "towxname":"示例的微信號(hào)", 
   "mpnews":{              
            "media_id":"123dsdajkasd231jhksad"               
             },
   "msgtype":"mpnews" 
}

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
   "errcode":0,
   "errmsg":"preview success",
   "msg_id":34182
}

查詢?nèi)喊l(fā)消息發(fā)送狀態(tài)【訂閱號(hào)與服務(wù)號(hào)認(rèn)證后均可用】

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/mass/get?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

{
   "msg_id": "201053012"
}

返回說(shuō)明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{
     "msg_id":201053012,
     "msg_status":"SEND_SUCCESS"
}

事件推送群發(fā)結(jié)果

由于群發(fā)任務(wù)提交后，群發(fā)任務(wù)可能在一定時(shí)間后才完成，因此，群發(fā)接口調(diào)用時(shí)，僅會(huì)給出群發(fā)任務(wù)是否提交成功的提示，若群發(fā)任務(wù)提交成功，則在群發(fā)任務(wù)結(jié)束時(shí)，會(huì)向開(kāi)發(fā)者在公眾平臺(tái)填寫的開(kāi)發(fā)者URL（callback URL）推送事件。

需要注意，由于群發(fā)任務(wù)徹底完成需要較長(zhǎng)時(shí)間，將會(huì)在群發(fā)任務(wù)即將完成的時(shí)候，就推送群發(fā)結(jié)果，此時(shí)的推送人數(shù)數(shù)據(jù)將會(huì)與實(shí)際情形存在一定誤差

推送的XML結(jié)構(gòu)如下（發(fā)送成功時(shí)）：

<xml>
<ToUserName><![CDATA[gh_3e8adccde292]]></ToUserName>
<FromUserName><![CDATA[oR5Gjjl_eiZoUpGozMo7dbBJ362A]]></FromUserName>
<CreateTime>1394524295</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[MASSSENDJOBFINISH]]></Event>
<MsgID>1988</MsgID>
<Status><![CDATA[sendsuccess]]></Status>
<TotalCount>100</TotalCount>
<FilterCount>80</FilterCount>
<SentCount>75</SentCount>
<ErrorCount>5</ErrorCount>
</xml>

此文來(lái)源于微信官方網(wǎng)站，所有權(quán)歸微信官方所有。