摘要：關于上傳圖文消息素材和新增永久圖文素材的區別上傳圖文消息素材等于是直接把圖文素材傳到微信的服務器，每次憑借獲取素材，并且不占用素材庫新增永久圖文素材在開發者和微信服務器之間，多了一個素材庫。

**說明
1.文章和有道筆記幾乎內容相同，所以如果有人在有道上有幸看到一樣的文章，應該也是我寫的，除非是全部復制
2.內容會較長，故會拆分多篇文章講解
3.目前基本的群發已記錄完結，如果后續有補充，會作說明**

一.官方文檔
高級群發接口
https://mp.weixin.qq.com/wiki...

二.關于群發接口
1.訂閱號每天可以群發消息一條，服務號每月（自然月）四條的群發權限。開發者模式下，可以通過高級群發接口，實現更靈活的群發能力。
2.注意
● 對于認證訂閱號，群發接口每天可成功調用1次，此次群發可選擇發送給全部用戶或某個標簽；
● 對于認證服務號雖然開發者使用高級群發接口的每日調用限制為100次，但是用戶每月只能接收4條，無論在公眾平臺網站上，還是使用接口群發，用戶每月只能接收4條群發消息，多于4條的群發將對該用戶發送失敗；
● 具備微信支付權限的公眾號，在使用群發接口上傳、群發圖文消息類型時，可使用a標簽加入外鏈；

● 開發者可以使用預覽接口校對消息樣式和排版，通過預覽接口可發送編輯好的消息給指定用戶校驗效果。
通俗的說就是
● 服務號一個月只能發四條消息，雖然一個月就四條 但它是即時呈現到客戶眼前 只要你打開微信就有一條未讀
● 訂閱號每天一條，但訂閱號所有的商家都在一起顯示，而且不會主動提醒，需要你點開服務號才可以看到
● 一條群發消息里，是可以包括多條圖文消息。
● 群發的消息不包括商家推送消息等其他消息類型。
如下所示，為京東的服務號消息界面。上面的是群發消息，下面是發貨通知消息。

這就是為什么有的人會疑惑，自己接受來自服務號的消息1個月不止4條，或者接受的消息怎么有好幾條。
3.群發圖文消息的過程
● 首先，預先將圖文消息中需要用到的圖片，使用上傳圖文消息內圖片接口，上傳成功并獲得圖片URL
● 上傳圖文消息素材，需要用到圖片時，請使用上一步獲取的圖片URL
● 使用對用戶標簽的群發，或對OpenID列表的群發，將圖文消息群發出去
● 在上述過程中，如果需要，還可以預覽圖文消息、查詢群發狀態，或刪除已群發的消息等
4.群發圖片、文本等其他消息類型的過程
● 如果是群發文本消息，則直接根據下面的接口說明進行群發即可
● 如果是群發圖片、視頻等消息，則需要預先通過素材管理接口準備好mediaID

5.關于群發時使用is_to_all為true使其進入公眾號在微信客戶端的歷史消息列表
● 使用is_to_all為true且成功群發，會使得此次群發進入歷史消息列表。
● 為防止異常，認證訂閱號在一天內，只能使用is_to_all為true進行群發一次，或者在公眾平臺官網群發（不管本次群發是對全體還是對某個分組）一次。以避免一天內有2條群發進入歷史消息列表。
● 類似地，服務號在一個月內，使用is_to_all為true群發的次數，加上公眾平臺官網群發（不管本次群發是對全體還是對某個分組）的次數，最多只能是4次。
● 設置is_to_all為false時是可以多次群發的，但每個用戶只會收到最多4條，且這些群發不會進入歷史消息列表。

注意
1.本接口中所有使用到media_id的地方，現在都可以使用素材管理中的永久素材media_id了。請但注意，使用同一個素材群發出去的鏈接是一樣的，這意味著，刪除某一次群發，會導致整個鏈接失效。
2.建議使用開發者模式的情況下，先使用預覽接口，因為接口每日可以調取100次。預覽達到預期效果后，才使用正式接口(openId列表群發)。
6.附說明：getWxAccessToken和https_request分別是我代碼中關于獲取微信全局token和調用第三方接口的方法。

三.群發消息接口——關于素材與接口
初學者很容易分不清楚開發文章當中，’素材管理‘與’消息管理-群發接口‘中，一些操作步驟的區別和用途，本人當時也是饒了很多坑，各種搜索與詢問，故記錄下來，為的就是日后能夠幫助同行少繞彎路，以及自己日后的溫習。如有錯誤的地方，懇請不臨指教，謝謝。
1.官文鏈接
● 高級群發
https://mp.weixin.qq.com/wiki...
● 素材管理
https://mp.weixin.qq.com/wiki...
2.關于素材
● 素材:在微信開發中，素材指的就是原始的媒體文件(如圖片、視頻、聲音等)以及圖文類型的文件
● 媒體文件是最基礎的素材，圖文素材等(比如含其他媒體文件的文件素材)其他素材需要獲取到基礎媒體文件素材,這個看具體也無需求
● 也就是說，你也可以選擇在群發消息的時候，發純文本素材
● 媒體素材通過接口上傳成功后，都會有一個媒體id，也就是media_id,這個媒體id用在之后需要調用的時候，是個關鍵。

 注意

● 上傳圖片素材分兩種：返回URL和返回media_id
● 素材管理分兩大類：永久和臨時
3.臨時素材與永久素材
● 臨時素材
公眾號經常有需要用到一些臨時性的多媒體素材的場景，例如在使用接口特別是發送消息時，對多媒體文件、多媒體消息的獲取和調用等操作，是通過media_id來進行的。素材管理接口對所有認證的訂閱號和服務號開放。通過本接口，公眾號可以新增臨時素材（即上傳臨時多媒體文件）。
請注意：
1、對于臨時素材，每個素材（media_id）會在開發者上傳或粉絲發送到微信服務器3天后自動刪除（所以用戶發送給開發者的素材，若開發者需要，應盡快下載到本地），以節省服務器資源。
2、media_id是可復用的。
3、素材的格式大小等要求與公眾平臺官網一致。具體是，圖片大小不超過2M，支持png/jpeg/jpg/gif格式，語音大小不超過5M，長度不超過60秒，支持mp3/amr格式
4、需使用https調用本接口。
● 永久素材
除了3天就會失效的臨時素材外，開發者有時需要永久保存一些素材，屆時就可以通過本接口新增永久素材。
最近更新，永久圖片素材新增后，將帶有URL返回給開發者，開發者可以在騰訊系域名內使用（騰訊系域名外使用，圖片將被屏蔽）。
請注意：
1、新增的永久素材也可以在公眾平臺官網素材管理模塊中看到
2、永久素材的數量是有上限的，請謹慎新增。圖文消息素材和圖片素材的上限為5000，其他類型為1000
3、素材的格式大小等要求與公眾平臺官網一致。具體是，圖片大小不超過2M，支持bmp/png/jpeg/jpg/gif格式，語音大小不超過5M，長度不超過60秒，支持mp3/wma/wav/amr格式
4、調用該接口需https協議
注意
● “永久素材”里的“最近更新...”文字所說的返回URL，就是前面提到的上傳圖片素材種類之一：返回圖片URL

      臨時素材與永久素材的不同之處

4.素材與群發接口的結合使用(以下講解的素材均以永久素材來說明)
第一步：上傳圖片
前面有提過，上傳圖片素材分兩種，主要是返回參數的不同
a.返回media_id(其實可以同時返回media_id和url)——文檔名：新增其他類型永久素材

使用說明
● 傳入參數：全局token和類型type
● 返回：media_id和url
● 可以根據業務邏輯需求，只返回media_id或者做判斷
● 注意:視頻素材的請求鏈接是不同的
● 使用：URL可以直接放在群發消息之圖文消息中的img標簽，media_id可以用在圖文消息的封面圖片id。
b.只返回URL——文檔名:上傳圖文消息內的圖片獲取URL

使用說明
● 傳入參數：全局token
● 返回：url
● URL作用:放在圖文消息中使用(使用img標簽)。
c.總結：只返回URL和返回media_id的區別就在于使用地方的不同，當然返回media_id的方法也可以返回URL。media_id用于群發圖文消息的封面，url用在文本的Img標簽。
第二步：上傳圖文素材等文件素材
a.新增永久圖文素材

b.上傳圖文消息素材
由于和上面的新增永久圖文素材差異不大，故這里不做贅述，詳情見第七條。

簡單說明
● thumb_media_id:前面提到的上傳圖片返回media_id(也就是“新增其他類型永久素材”)就是用在此處，作為圖文消息的封面圖片。
● content:前面提到的上傳圖片2種類型，返回的URL就是用在此處的img標簽里。
5.關于“上傳圖文消息素材”和“新增永久圖文素材”的區別
● 上傳圖文消息素材：等于是直接把圖文素材傳到微信的服務器，每次憑借media_id獲取素材，并且不占用素材庫
● 新增永久圖文素材：在開發者和微信服務器之間，多了一個素材庫。素材庫的素材有數量限制，但是可以直接查看到。

四.群發消息接口——第1步：上傳圖片(返回URL)
1.說明
● 功能:上傳圖文消息內的圖片獲取URL【訂閱號與服務號認證后均可用】
● 注意:本接口所上傳的圖片不占用公眾號的素材庫中圖片數量的5000個的限制。圖片僅支持jpg/png格式，大小必須在1MB以下
● 官方文檔參考

2.代碼實現
a.思路
● 調用接口

    https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN

看到后面需要用token，就知道，肯定也是需要獲取到全局的token，再組裝url。
● 參數說明
調用示例（使用curl命令，用FORM表單方式上傳一個圖片）：
curl -F media=@test .jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
從官文中可以看出，圖片名(帶格式的圖片名)需要在media(代表媒體)之后，并加@符號。
這里就涉及到CURL的知識:
curl上傳：文件的標識@+相對路徑
b.代碼實現
注:以下是我的代碼實現，大家可以根據自己的項目去實際編寫

    function addMaterial() {
        $access_token = $this->getWxAccessToken();    
        $url = "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=".$access_token;
        $filename = "文件名，帶路徑";
        $data=array("media"=>"@". $filename);
        print_R($data);
        $res=$this->https_request( $url ,"post", "json", $data);
        dump($res); exit();
        return $res;
    }

● 說明
——方法為了實現功能，寫的都比較直接。后續可以對代碼進行改編，方法里的參數可以使用傳參的方式，這樣使用起來也比較靈活。
—— filename:文件名，相對于項目的入口文件，一般是根目錄的路徑。比如我編寫此代碼的時候用的是ThinkPHP框架，項目根目錄有個index.php入口文件，在根目錄有個Public，圖片是直接放在Public下的，所以上述的filename應該是Public/圖片名.格式，請大家根據自己實際圖片路徑去寫。
——print_r和dump是為了看打印的結果，這個大家測試的時候可以使用下，方便查看，無誤后去掉即可。

四.群發消息接口——第1步：上傳素材(包括圖片、視頻、聲音等，返回URL和MediaId,推薦)
1.說明
● 新增的永久素材也可以在公眾平臺官網素材管理模塊中看到
● 永久素材的數量是有上限的，請謹慎新增。圖文消息素材和圖片素材的上限為5000，其他類型為1000
● 素材的格式大小等要求與公眾平臺官網一致。具體是，圖片大小不超過2M，支持bmp/png/jpeg/jpg/gif格式，語音大小不超過5M，長度不超過60秒，支持mp3/wma/wav/amr格式
● 調用接口需https協議
● 官方文檔參考

● 注意:官方說明，視頻素材需要另外一個表單，這里暫不做說明。
● 通過POST表單來調用接口，表單id為media，包含需要上傳的素材內容，有filename、filelength、content-type等信息
● 注意：圖片素材將進入公眾平臺官網素材管理模塊中的默認分組
2.代碼實現
a.思路
● 調用接口

  https://api.weixin.qq.com/cgi-bin/material/add_material?        access_token=ACCESS_TOKEN&type=TYPE

看到后面需要用token，就知道，肯定也是需要獲取到全局的token，再組裝url，此外type類型也需要指定。
● 官方關于類型等其他參數說明如下
參數是否必須說明access_token是調用接口憑證type是媒體文件類型，分別有圖片（image）、語音（voice）、視頻（video）和縮略圖（thumb）media是form-data中媒體文件標識，有filename、filelength、content-type等信息

b.代碼實現
注:以下是我的代碼實現，大家可以根據自己的項目去實際編寫

    function addMaterial() {
        $access_token = $this->getWxAccessToken();
        $type="image";
        //https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
        $url = "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=".$access_token."&type=".$type;
        $filename = "文件名";
        $data=array("media"=>"@". $filename);
        $res=$this->https_request( $url ,"post", "json", $data);
        return $res["media_id"];
    }

● 說明
——方法為了實現功能，寫的都比較直接。后續可以對代碼進行改編，方法里的參數可以使用傳參的方式，這樣使用起來也比較靈活。
—— filename:帶格式的文件名，相對于項目的入口文件，一般是根目錄的路徑。比如我編寫此代碼的時候用的是ThinkPHP框架，項目根目錄有個index.php入口文件，在根目錄有個Public，圖片是直接放在Public下的，所以上述的filename才是如此格式，請大家根據自己實際圖片路徑去寫。
——type:傳入的媒體類型
——作用:返回的media_id用作新增圖文素材中的圖文消息封面素材id，url用作新增圖文素材中，content(圖文消息的具體內容)的img標簽。

六.群發消息接口——第2步：上傳圖文之新增永久圖文素材

1.說明
● 接口
https://api.weixin.qq.com/cgi...

2.注意
● thumb_media_id:需要先上傳圖片素材，且圖文消息的封面圖片素材id必須是永久mediaID
● content:上傳圖片素材的2種方式，都有返回url,就是用在此處的img標簽中。
● 返回:media_id用于調用后面的群發消息時使用
● 注意:圖文消息內容，將過濾外部的圖片鏈接
3.代碼實現

    function addNews(){
        $access_token = $this->getWxAccessToken();
        $thumb_media_id=$this->addMaterial();
        $content_img=$this->addMaterialUrl();
        $url = "https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=".$access_token;
        $array = array(
                "articles" => array(                                /*若新增的是多圖文素材，則此處應還有幾段articles結構  */
                                 array(
                         "title"               => urlencode("最后一組測試——1"),
                                "thumb_media_id"      => $thumb_media_id,        //圖文消息的封面圖片素材id（必須是永久mediaID）
                                "author"              => urlencode("測試編輯1"),            //作者
                                "digest"             => urlencode("這是測試的摘要1"),            //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空
                                "show_cover_pic"      => 1,            //是否顯示封面，0為false，即不顯示，1為true，即顯示
                                "content"             => urlencode("
這是一個測試文章1


測試下圖文素材的效果

測試下圖文素材的效果
"),            //圖文消息的具體內容，支持HTML標簽，必須少于2萬字符，小于1M，且此處會去除JS
                                "content_source_url" => urlencode("http://www.地址")            //圖文消息的原文地址，即點擊“閱讀原文”后的URL
                        ),    
                        array(
                                "title"               => urlencode("最后一組測試——2"),
                                "thumb_media_id"      => $thumb_media_id,        //圖文消息的封面圖片素材id（必須是永久mediaID）
                                "author"              => urlencode("測試編輯2"),            //作者
                                "digest"             => urlencode("這是測試的摘要2"),            //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空
                                "show_cover_pic"      => 1,            //是否顯示封面，0為false，即不顯示，1為true，即顯示
                                "content"             => urlencode("
這是一個測試文章2


測試下圖文素材的效果

測試下圖文素材的效果
"),            //圖文消息的具體內容，支持HTML標簽，必須少于2萬字符，小于1M，且此處會去除JS
                                "content_source_url" => urlencode("http://www.地址")            //圖文消息的原文地址，即點擊“閱讀原文”后的URL
                        ),
               ),
               
        );
        $postJson = urldecode( json_encode( $array ) );
        //dump($postJson);
        $res=$this->https_request( $url ,"post", "json", $postJson);
        //dump($res["media_id"]);exit();
        return $res["media_id"];
        }

說明
● addMaterial():是我寫的新增其他類型永久素材，里面新增的是圖片。
● addMaterialUrl()：是我寫的一個關于上傳圖片只返回URL的方法。雖然返回的只有URL，但也是個數組，所以，要么在方法里返回結果的時候，就取下標url返回，要么調用的時候取下標url使用。
● urlencode和urldecode：因為后面POST的是一個JSON數組。如果JSON數據里有中文，那么需要用urlencode先轉，后面再用urldecode轉過來。
● 需要注意的是，我的html標記屬性用的是單引號，所以無需轉義。如果你使用了雙引號，需要用htmlspecialchars轉義，再用htmlspecialchars_decode轉回來。
● 請使用三維數組!!!看官方示例，如果以PHP寫數組的寫法來看，似乎不熟悉的人都會寫成二維數組，但是這樣是無法解析的，在articles里，還有一層數組！！

七.群發消息接口——第2步：上傳圖文之上傳圖文消息素材
1.說明
● 接口
https://api.weixin.qq.com/cgi...
● 官文說明

2.代碼實現

    function uploadNews(){
        //1.獲取全局access_token
        $access_token = $this->getWxAccessToken();    
        $url = "https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token=".$access_token;
        //2.組裝數據    
        $thumb_media_id=$this->addMaterial();
        $content_img=$this->addMaterialUrl();
        $array = array(
                "articles" => array(                                /*若新增的是多圖文素材，則此處應還有幾段articles結構  */
                        array(
                                "thumb_media_id"      => $thumb_media_id,        //圖文消息縮略圖的media_id，可以在基礎支持-上傳多媒體文件接口中獲得
                                "author"              => urlencode("編輯1"),            //作者
                                "title"               => urlencode("這是測試的標題——1"),
                                "content_source_url" => urlencode("http://www.地址"),            //圖文消息的原文地址，即點擊“閱讀原文”后的URL                                                        
                                "content"             => urlencode("
這是一個測試文章——1


測試下圖文素材的效果——1

測試下圖文素材的效果——1
"),            //圖文消息的具體內容，支持HTML標簽，必須少于2萬字符，小于1M，且此處會去除JS
                                "digest"             => urlencode("這是測試的摘要1"),            //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空
                                "show_cover_pic"      => 1            //是否顯示封面，0為false，即不顯示，1為true，即顯示
                         ),//第一個圖文文
                         array(
                                 "thumb_media_id"      => $thumb_media_id,        //圖文消息縮略圖的media_id，可以在基礎支持-上傳多媒體文件接口中獲得
                                 "author"              => urlencode("編輯2"),            //作者
                                 "title"               => urlencode("這是測試的標題——2"),
                                 "content_source_url" => urlencode("http://www.地址"),            //圖文消息的原文地址，即點擊“閱讀原文”后的URL
                                 "content"             => urlencode("
這是一個測試文章——2


測試下圖文素材的效果——1

測試下圖文素材的效果——1
"),            //圖文消息的具體內容，支持HTML標簽，必須少于2萬字符，小于1M，且此處會去除JS
                                 "digest"             => urlencode("這是測試的摘要2"),            //圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空
                                 "show_cover_pic"      => 1            //是否顯示封面，0為false，即不顯示，1為true，即顯示
                         ),//第2個圖文
                ),
        );
        $postJson = urldecode( json_encode( $array ) );
        $res=$this->https_request( $url ,"post", "json", $postJson);
        //dump($res);
        return $res["media_id"];
    }

說明
● $thumb_media_id和$content_img的獲取方法：均為前文中提到的方法
● 注意：articles下的數組個數，取決于你要發送的圖文消息個數，但一次最多8個

八.群發消息接口——第3步：預覽接口(非必須步驟，但建議保留)
1.意義:為了防止開發者模式下，每月發送4條消息的限制，從而導致不滿意消息的效果現象。
2.官方文檔

注意:雖然預覽接口調用的次數較多，但是每天有100次的限制，請注意！！！
3.代碼實現——純文本

function sendMsgAll(){
        //1.獲取全局access_token
        $access_token = $this->getWxAccessToken();    

$openid="我的openid";

        //2.組裝群發預覽接口數據  array
        $url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=".$access_token;
        $array =array(        
                "touser"=> $openid,        //openid
                "text"  => array("content" => "雨紛紛，舊故里草木深"),                //文本內容
                "msgtype" => "text"                                //格式
        );
        //3.將數組轉成json格式
        $postJson = json_encode ( $array );
        //4.調用第三方接口
        $res = $this->https_request( $url ,"post", "json",$postJson);
        return $res;
    }

4.代碼實現——圖文

function sendMsgAllPreview(){
        //1.獲取全局access_token
        $access_token = $this->getWxAccessToken();    
        $openid="我的openid";
        $media_id=$this->addNews();
        //2.組裝群發預覽接口數據  array
        $url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview?access_token=".$access_token;
        $array = array(
                "touser" =>$openid,
                "mpnews"=>array("media_id"=>$media_id),
                "msgtype"=>"mpnews"
        );                 
        //3.將數組轉成json格式
        $postJson = json_encode ( $array );
        //4.調用第三方接口
        $res = $this->https_request( $url ,"post", "json",$postJson);
        //dump($res); 
        return $res;
    }

說明
● $openid:此處因為是做預覽，只需要一個ID，獲取有很多種方法。比如之前獲取用戶信息的時候，可以獲取到openid，或者是測試號的id都可以，只要是合法的openid。
● mpnews：媒體id。需要你之前有上傳過圖文消息的素材，獲得素材的id。
疑問：我預覽接口是成功的，返回是0，但是沒有官方示例的msg_id...難道改版了？知道的麻煩不吝賜教，謝謝。

九.群發消息接口——第4步:根據標簽進行群發
1.說明
● 接口
https://api.weixin.qq.com/cgi...
● 官方說明

2.代碼實現

//根據標簽進行群發
    function sendAllByTag(){
        //1.獲取全局access_token
        $access_token = $this->getWxAccessToken();    
        $url = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=".$access_token;
        //2.組裝數據
        $media_id=$this->addNews();
        $array=array(
                "filter" => array(            //用于設定圖文消息的接收者
                    "is_to_all" => true,            //是否向全部用戶發送，值為true或false，選擇true該消息群發給所有用戶，選擇false可根據tag_id發送給指定群組的用戶
                    "tag_id"     =>"",            //群發到的標簽的tag_id，參加用戶管理中用戶分組接口，若is_to_all值為true，可不填寫tag_id
                ),
                "mpnews" => array(            //用于設定即將發送的圖文消息
                    "media_id"  => $media_id,            //用于群發的消息的media_id
                ),
                "msgtype"=> "mpnews",                //群發的消息類型，圖文消息為mpnews，文本消息為text，語音為voice，音樂為music，圖片為image，視頻為video，卡券為wxcard
        );
        $postJson = json_encode( $array );
        $res=$this->https_request( $url ,"post", "json", $postJson);
        //dump($res);
        return $res;
    }

注意
● 認證后的服務號每個月就4次群發消息機會!!!請謹慎...建議使用前先使用預覽接口先發給自己的賬號測試看看效果，再用正式的接口。
● 附帶個疑問:不知道為什么，上傳圖文消息素材獲取不到最后的id，一直報錯40007，但是新增永久圖文素材的一直是正確的。鬧心，查了好久也查不出來。
40007不合法的媒體文件id