微信公眾平臺高級群發(fā)功能接口

珠海微信營銷網(wǎng)：微信官方公眾平臺網(wǎng)站上，為微信訂閱號提供了每天一條的群發(fā)權限，為微信服務號提供每月4條的群發(fā)權限，而對于某些具備開發(fā)能力的公眾號運營者，可以通過高級群發(fā)接口，實現(xiàn)更靈活的群發(fā)能力。

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

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

2、上傳圖文消息素材，需要用到圖片時，請使用上一步獲取的圖片URL；

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

接口調(diào)用請求說明

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

參數(shù)說明

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

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

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

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息。

上傳圖文消息素材【訂閱號與服務號認證后均可用】

接口調(diào)用請求說明

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

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

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"
		 }
   ]
}

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息。

根據(jù)分組進行群發(fā)【訂閱號與服務號認證后均可用】

接口調(diào)用請求說明

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

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

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

圖文消息（注意圖文消息的media_id需要通過上述方法來得到）：

{
   "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"
}

語音（注意此處media_id需通過基礎支持中的上傳下載多媒體文件來得到）：

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

圖片（注意此處media_id需通過基礎支持中的上傳下載多媒體文件來得到）：

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

視頻

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

{
  "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），即可進行發(fā)送

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

卡券消息（注意圖文消息的media_id需要通過上述方法來得到）：

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

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

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

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息、

根據(jù)OpenID列表群發(fā)【訂閱號不可用，服務號認證后可用】

接口調(diào)用請求說明

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

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

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

圖文消息（注意圖文消息的media_id需要通過上述方法來得到）：

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

文本：

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

語音：

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

圖片：

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

視頻：

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

{
  "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），即可進行發(fā)送

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

卡券：

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

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

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

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息。

刪除群發(fā)【訂閱號與服務號認證后均可用】

接口調(diào)用請求說明

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

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

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

{
   "msg_id":30124
}

請注意：

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

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息。

預覽接口【訂閱號與服務號認證后均可用】

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

接口調(diào)用請求說明

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

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

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

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

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

文本：

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

語音（其中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" 
}

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

{
   "towxname":"示例的微信號", 
   "mpnews":{              
            "media_id":"123dsdajkasd231jhksad"               
             },
   "msgtype":"mpnews" 
}

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

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

接口調(diào)用請求說明

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

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

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

{
   "msg_id": "201053012"
}

返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：

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

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

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

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

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

<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>

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