狠狠色丁香婷婷综合尤物/久久精品综合一区二区三区/中国有色金属学报/国产日韩欧美在线观看 - 国产一区二区三区四区五区tv

LOGO OA教程 ERP教程 模切知識交流 PMS教程 CRM教程 開發(fā)文檔 其他文檔  
 
網(wǎng)站管理員

微信企業(yè)號開發(fā)之如何接收消息(1)
admin
2014年12月2日 0:45 本文熱度 6332




文章簡介：將應(yīng)用設(shè)置在回調(diào)模式時，企業(yè)可以通過回調(diào)URL接收員工回復(fù)的消息，以及員工關(guān)注、點擊菜單、上報地理位置等事件。在接收到事件后，企業(yè)可以發(fā)送被動響應(yīng)消息，實現(xiàn)員工與企業(yè)的互動。

將應(yīng)用設(shè)置在回調(diào)模式時，企業(yè)可以通過回調(diào)URL接收員工回復(fù)的消息，以及員工關(guān)注、點擊菜單、上報地理位置等事件。


在接收到事件后，企業(yè)可以發(fā)送被動響應(yīng)消息，實現(xiàn)員工與企業(yè)的互動。


注意，企業(yè)在接收消息，以及發(fā)送被動響應(yīng)消息時，消息體都以AES方式加密，以保證傳輸?shù)陌踩＞唧w可參考'建立連接'中的'回調(diào)模式'一節(jié)。


一、關(guān)注與取消關(guān)注


員工在關(guān)注企業(yè)號時，首先要與企業(yè)通訊錄中的帳號綁定；如果企業(yè)開啟了二次驗證，那么在綁定成功后還需要經(jīng)過企業(yè)的驗證，才可以關(guān)注成功。


1、員工與通訊錄中的帳號綁定


員工關(guān)注企業(yè)號時，會根據(jù)員工的微信號、微信綁定的手機或郵箱，與企業(yè)通訊錄的帳號匹配。如果匹配到，則綁定成功；否則會提示員工輸入手機號或郵箱，驗證成功后再與企業(yè)通訊錄中的帳號匹配。注意，員工的微信版本需要在5.4以上，目前僅支持iOS、Android兩個平臺。


2、二次驗證


企業(yè)在開啟二次驗證時，必須填寫企業(yè)二次驗證頁面的url。當(dāng)員工綁定通訊錄中的帳號后，會收到一條圖文消息，引導(dǎo)員工到企業(yè)的驗證頁面驗證身份，企業(yè)在員工驗證成功后，調(diào)用如下接口即可讓員工關(guān)注成功。



  • 請求說明

Http請求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/authsucc?access_token=ACCESS_TOKEN&userid=USERID



  • 參數(shù)說明














參數(shù) 必須 說明
access_token 是 調(diào)用接口憑證
userid 是 員工UserID


  • 權(quán)限說明

管理員須擁有userid對應(yīng)員工的管理權(quán)限。



  • 返回結(jié)果 
  1. { 
  2.    "errcode": "0", 
  3.    "errmsg": "ok" 
  4. } 

3、關(guān)注/取消關(guān)注事件的推送


員工關(guān)注、取消關(guān)注企業(yè)號的事件，會推送到每個應(yīng)用在管理端設(shè)置的URL；特別的，默認企業(yè)小助手可以用于獲取整個企業(yè)號的關(guān)注狀況。（以下假設(shè)該URL為http://api.3dept.com）。



  • 請求說明

Http請求方式: POST


http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS&timestamp=13500001234&nonce=123412323



  • 參數(shù)說明 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[UserID]]></FromUserName> 
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[event]]></MsgType> 
  6.    <Event><![CDATA[subscribe]]></Event> 
  7.    <AgentID>1</AgentID> 
  8. </xml> 























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間 （整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，subscribe(訂閱)、unsubscribe(取消訂閱)
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面獲取；如果id為0，則表示是整個企業(yè)號的關(guān)注/取消關(guān)注事件


二、接收普通消息


普通消息是指員工向企業(yè)號應(yīng)用發(fā)送的消息，包括文本、圖片、語音、視頻、地理位置等類型。



  • text消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName>  
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[text]]></MsgType> 
  6.    <Content><![CDATA[this is a test]]></Content> 
  7.    <MsgId>1234567890123456</MsgId> 
  8.    <AgentID>1</AgentID> 
  9. </xml> 


























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內(nèi)容
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


  • image消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName>  
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[text]]></MsgType> 
  6.    <Content><![CDATA[this is a test]]></Content> 
  7.    <MsgId>1234567890123456</MsgId> 
  8.    <AgentID>1</AgentID> 
  9. </xml> 


























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內(nèi)容
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


  • image消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[image]]></MsgType> 
  6.    <PicUrl><![CDATA[this is a url]]></PicUrl> 
  7.    <MediaId><![CDATA[media_id]]></MediaId> 
  8.    <MsgId>1234567890123456</MsgId> 
  9.    <AgentID>1</AgentID> 
  10. </xml> 





























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：image
PicUrl 圖片鏈接
MediaId 圖片消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


  • voice消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1357290913</CreateTime> 
  5.    <MsgType><![CDATA[voice]]></MsgType> 
  6.    <MediaId><![CDATA[media_id]]></MediaId> 
  7.    <Format><![CDATA[Format]]></Format> 
  8.    <MsgId>1234567890123456</MsgId> 
  9.    <AgentID>1</AgentID> 
  10. </xml> 





























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：voice
MediaId 語音消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
Format 語音格式，如amr，speex等
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


  • video消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1357290913</CreateTime> 
  5.    <MsgType><![CDATA[video]]></MsgType> 
  6.    <MediaId><![CDATA[media_id]]></MediaId> 
  7.    <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> 
  8.    <MsgId>1234567890123456</MsgId> 
  9.    <AgentID>1</AgentID> 
  10. </xml> 





























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：video
MediaId 視頻消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
ThumbMediaId 視頻消息縮略圖的媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


  • location消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1351776360</CreateTime> 
  5.    <MsgType><![CDATA[location]]></MsgType> 
  6.    <Location_X>23.134521</Location_X> 
  7.    <Location_Y>113.358803</Location_Y> 
  8.    <Scale>20</Scale> 
  9.    <Label><![CDATA[位置信息]]></Label> 
  10.    <MsgId>1234567890123456</MsgId> 
  11.    <AgentID>1</AgentID> 
  12. </xml> 



































參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：location
Location_X 地理位置緯度
Location_Y 地理位置經(jīng)度
Scale 地圖縮放大小
Label 地理位置信息
MsgId 消息id，64位整型
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


三、接收事件


事件是指員工在企業(yè)號上的某些操作行為，比如關(guān)注、上報地理位置、點擊菜單等。（關(guān)注事件請參考’關(guān)注與取消關(guān)注’）


1、菜單事件推送


員工點擊自定義菜單后，微信會把點擊事件推送給企業(yè)。請注意，點擊菜單彈出子菜單，不會產(chǎn)生上報。



  • 參數(shù)說明 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[FromUser]]></FromUserName> 
  4.    <CreateTime>123456789</CreateTime> 
  5.    <MsgType><![CDATA[event]]></MsgType> 
  6.    <Event><![CDATA[click]]></Event> 
  7.    <EventKey><![CDATA[EVENTKEY]]></EventKey> 
  8.    <AgentID>001</AgentID> 
  9. </xml> 


























參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，可為click或view，對應(yīng)菜單創(chuàng)建時的類型
EventKey 事件KEY值，與菜單接口中KEY值對應(yīng)
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看

2、上報地理位置事件


員工同意上報地理位置后，每次在進入應(yīng)用會話時都會上報一次地理位置，或在進入應(yīng)用會話后每5秒上報一次地理位置。企業(yè)可以在管理端修改應(yīng)用的以上 設(shè)置。上報地理位置時，微信會將此事件推送到企業(yè)應(yīng)用在管理端設(shè)置的URL（以下假設(shè)該URL為http://api.3dept.com）。



  • 請求說明

Http請求方式: POST


http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS&timestamp=13500001234&nonce=123412323



  • 參數(shù)說明 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[FromUser]]></FromUserName> 
  4.    <CreateTime>123456789</CreateTime> 
  5.    <MsgType><![CDATA[event]]></MsgType> 
  6.    <Event><![CDATA[LOCATION]]></Event> 
  7.    <Latitude>23.104105</Latitude> 
  8.    <Longitude>113.320107</Longitude> 
  9.    <Precision>65.000000</Precision> 
  10.    <AgentID>001</AgentID> 
  11. </xml> 
































參數(shù) 說明
ToUserName 企業(yè)號CorpID
FromUserName 員工UserID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，此時固定為：LOCATION
Latitude 地理位置緯度
Longitude 地理位置經(jīng)度
Precision 地理位置精度
AgentID 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看


四、被動響應(yīng)消息


企業(yè)響應(yīng)的消息同樣應(yīng)該經(jīng)過加密，并帶上msg_signature、timestamp、nonce及密文，以下是標準的回包：

  1. <xml> 
  2.    <Encrypt><![CDATA[msg_encrypt]]></Encrypt> 
  3.    <MsgSignature><![CDATA[msg_signature]]></MsgSignature> 
  4.    <TimeStamp>timestamp</TimeStamp> 
  5.    <Nonce><![CDATA[nonce]]></Nonce> 
  6. </xml> 

以下是各類型消息的明文XML結(jié)構(gòu)：



  • text消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName>  
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[text]]></MsgType> 
  6.    <Content><![CDATA[this is a test]]></Content> 
  7. </xml> 




















參數(shù) 說明
ToUserName 員工UserID
FromUserName 企業(yè)號CorpID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內(nèi)容


  • image消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1348831860</CreateTime> 
  5.    <MsgType><![CDATA[image]]></MsgType> 
  6.    <Image> 
  7.        <MediaId><![CDATA[media_id]]></MediaId> 
  8.    </Image> 
  9. </xml> 




















參數(shù) 說明
ToUserName 員工UserID
FromUserName 企業(yè)號CorpID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：image
MediaId 圖片消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。


  • voice消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1357290913</CreateTime> 
  5.    <MsgType><![CDATA[voice]]></MsgType> 
  6.    <Voice> 
  7.        <MediaId><![CDATA[media_id]]></MediaId> 
  8.    </Voice> 
  9. </xml> 




















參數(shù) 說明
ToUserName 員工UserID
FromUserName 企業(yè)號CorpID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：voice
MediaId 語音消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)


  • video消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>1357290913</CreateTime> 
  5.    <MsgType><![CDATA[video]]></MsgType> 
  6.    <Video> 
  7.        <MediaId><![CDATA[media_id]]></MediaId> 
  8.        <Title><![CDATA[title]]></Title> 
  9.        <Description><![CDATA[description]]></Description> 
  10.    </Video> 
  11. </xml> 


























參數(shù) 說明
ToUserName 員工UserID
FromUserName 企業(yè)號CorpID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：video
MediaId 視頻消息媒體id，可以調(diào)用多媒體文件下載接口拉取數(shù)據(jù)。
Title 視頻消息的標題
Description 視頻消息的描述


  • news消息 
  1. <xml> 
  2.    <ToUserName><![CDATA[toUser]]></ToUserName> 
  3.    <FromUserName><![CDATA[fromUser]]></FromUserName> 
  4.    <CreateTime>12345678</CreateTime> 
  5.    <MsgType><![CDATA[news]]></MsgType> 
  6.    <ArticleCount>2</ArticleCount> 
  7.    <Articles> 
  8.        <item> 
  9.            <Title><![CDATA[title1]]></Title>  
  10.            <Description><![CDATA[description1]]></Description> 
  11.            <PicUrl><![CDATA[picurl]]></PicUrl> 
  12.            <Url><![CDATA[url]]></Url> 
  13.        </item> 
  14.        <item> 
  15.            <Title><![CDATA[title]]></Title> 
  16.            <Description><![CDATA[description]]></Description> 
  17.            <PicUrl><![CDATA[picurl]]></PicUrl> 
  18.            <Url><![CDATA[url]]></Url> 
  19.        </item> 
  20.    </Articles> 
  21. </xml> 
































參數(shù) 說明
ToUserName 員工UserID
FromUserName 企業(yè)號CorpID
CreateTime 消息創(chuàng)建時間（整型）
MsgType 消息類型，此時固定為：news
ArticleCount 多條圖文消息信息，默認第一個item為大圖,注意，如果圖文數(shù)超過10，則將會無響應(yīng)
Title 圖文消息標題
Description 圖文消息描述
PicUrl 圖片鏈接，支持JPG、PNG格式，較好的效果為大圖360*200，小圖200*200
Url 點擊圖文消息跳轉(zhuǎn)鏈接

該文章在 2014/12/2 0:45:08 編輯過
關(guān)鍵字查詢
相關(guān)文章
正在查詢...
點晴ERP是一款針對中小制造業(yè)的專業(yè)生產(chǎn)管理軟件系統(tǒng),系統(tǒng)成熟度和易用性得到了國內(nèi)大量中小企業(yè)的青睞。
點晴PMS碼頭管理系統(tǒng)主要針對港口碼頭集裝箱與散貨日常運作、調(diào)度、堆場、車隊、財務(wù)費用、相關(guān)報表等業(yè)務(wù)管理，結(jié)合碼頭的業(yè)務(wù)特點，圍繞調(diào)度、堆場作業(yè)而開發(fā)的。集技術(shù)的先進性、管理的有效性于一體，是物流碼頭及其他港口類企業(yè)的高效ERP管理信息系統(tǒng)。
點晴WMS倉儲管理系統(tǒng)提供了貨物產(chǎn)品管理,銷售管理,采購管理,倉儲管理,倉庫管理,保質(zhì)期管理,貨位管理,庫位管理,生產(chǎn)管理,WMS管理系統(tǒng),標簽打印,條形碼,二維碼管理,批號管理軟件。
點晴免費OA是一款軟件和通用服務(wù)都免費，不限功能、不限時間、不限用戶的免費OA協(xié)同辦公管理系統(tǒng)。
Copyright 2010-2025 ClickSun All Rights Reserved