企業(yè)可以主動發(fā)消息給員工，消息量不受限制。

調(diào)用接口時，使用Https協(xié)議、JSON數(shù)據(jù)包格式，數(shù)據(jù)包不需做加密處理。

目前支持文本、圖片、語音、視頻、文件、圖文等消息類型。除了news類型，其它類型的消息可在發(fā)送時加上保密選項，保密消息會被打上水印，并且只有接收者才能閱讀。

一、發(fā)送接口說明

• 請求說明

Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

• 參數(shù)說明

• 權(quán)限要求

需要管理員對應(yīng)用有使用權(quán)限，對收件人touser、toparty、totag有查看權(quán)限，否則本次調(diào)用失敗。

• 返回結(jié)果

如果對應(yīng)用或收件人、部門、標(biāo)簽任何一個無權(quán)限，則本次發(fā)送失?。蝗绻占?、部門或標(biāo)簽不存在，發(fā)送仍然執(zhí)行，但返回?zé)o效的部分。

{ 
   "errcode": 0, 
   "errmsg": "ok", 
   "invaliduser": "UserID1", 
   "invalidparty":"PartyID1", 
   "invalidtag":"TagID1" 
} 

二、消息類型及數(shù)據(jù)格式

• text消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "text", 
   "agentid": "1", 
   "text": { 
       "content": "Holiday Request For Pony(http://xxxxx)" 
   }, 
   "safe":"0" 
} 

• image消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "msgtype": "image", 
   "agentid": "1", 
   "image": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 

• voice消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "voice", 
   "agentid": "1", 
   "voice": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 

• video消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "video", 
   "agentid": "1", 
   " video": { 
       "media_id": "MEDIA_ID", 
       "title": "Title", 
       "description": "Description" 
   }, 
   "safe":"0" 
} 

• file消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "file", 
   "agentid": "1", 
   "file": { 
       "media_id": "MEDIA_ID" 
   }, 
   "safe":"0" 
} 

• news消息

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "news", 
   "agentid": "1", 
   "news": { 
       "articles":[ 
           { 
               "title": "Title", 
               "description": "Description", 
               "url": "URL", 
               "picurl": "PIC_URL", 
           }, 
           { 
               "title": "Title", 
               "description": "Description", 
               "url": "URL", 
               "picurl": "PIC_URL", 
           }     
       ] 
   } 
} 

• mpnews消息

注：mpnews消息與news消息類似，不同的是圖文消息內(nèi)容存儲在微信后臺，并且支持保密選項。

{ 
   "touser": "UserID1|UserID2|UserID3", 
   "toparty": " PartyID1 | PartyID2 ", 
   "totag": " TagID1 | TagID2 ", 
   "msgtype": "mpnews", 
   "agentid": "1", 
   "mpnews": { 
       "articles":[ 
           { 
               "thumb_media_id": "id", 
               "author": "Author", 
               "content_source_url": "URL", 
               "content": "Content" 
               "digest": "Digest description", 
               "show_cover_pic": "0" 
           }, 
           {  
               "thumb_media_id": "id", 
               "author": "Author", 
               "content_source_url": "URL", 
               "content": "Content" 
               "digest": "Digest description", 
               "show_cover_pic": "0" 
           } 
       ] 
       "media_id": "id" 
   } 
   "safe":"0" 
}