成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看

微信企業號開發之如何接收消息

作者：51CTO整理
移動開發 移動應用
將應用設置在回調模式時，企業可以通過回調URL接收員工回復的消息，以及員工關注、點擊菜單、上報地理位置等事件。在接收到事件后，企業可以發送被動響應消息，實現員工與企業的互動。

將應用設置在回調模式時，企業可以通過回調URL接收員工回復的消息，以及員工關注、點擊菜單、上報地理位置等事件。

在接收到事件后，企業可以發送被動響應消息，實現員工與企業的互動。

注意，企業在接收消息，以及發送被動響應消息時，消息體都以AES方式加密，以保證傳輸的安全。具體可參考'建立連接'中的'回調模式'一節。

一、關注與取消關注

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

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

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

2、二次驗證

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

  • 請求說明

Http請求方式: GET

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

  • 參數說明
參數 必須 說明
access_token 是 調用接口憑證
userid 是 員工UserID
  • 權限說明

管理員須擁有userid對應員工的管理權限。

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

3、關注/取消關注事件的推送

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

  • 請求說明

Http請求方式: POST

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

  • 參數說明
  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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間 （整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，subscribe(訂閱)、unsubscribe(取消訂閱)
AgentID 企業應用的id，整型。可在應用的設置頁面獲取；如果id為0，則表示是整個企業號的關注/取消關注事件

#p#

二、接收普通消息

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

  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內容
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看
  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內容
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看
  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：image
PicUrl 圖片鏈接
MediaId 圖片消息媒體id，可以調用多媒體文件下載接口拉取數據。
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看
  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：voice
MediaId 語音消息媒體id，可以調用多媒體文件下載接口拉取數據。
Format 語音格式，如amr，speex等
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看
  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：video
MediaId 視頻消息媒體id，可以調用多媒體文件下載接口拉取數據。
ThumbMediaId 視頻消息縮略圖的媒體id，可以調用多媒體文件下載接口拉取數據。
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看
  • 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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：location
Location_X 地理位置緯度
Location_Y 地理位置經度
Scale 地圖縮放大小
Label 地理位置信息
MsgId 消息id，64位整型
AgentID 企業應用的id，整型。可在應用的設置頁面查看

#p#

三、接收事件

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

1、菜單事件推送

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

  • 參數說明
  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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，可為click或view，對應菜單創建時的類型
EventKey 事件KEY值，與菜單接口中KEY值對應
AgentID 企業應用的id，整型。可在應用的設置頁面查看

2、上報地理位置事件

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

  • 請求說明

Http請求方式: POST

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

  • 參數說明
  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> 
參數 說明
ToUserName 企業號CorpID
FromUserName 員工UserID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：event
Event 事件類型，此時固定為：LOCATION
Latitude 地理位置緯度
Longitude 地理位置經度
Precision 地理位置精度
AgentID 企業應用的id，整型。可在應用的設置頁面查看

#p#

四、被動響應消息

企業響應的消息同樣應該經過加密，并帶上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結構：

  • 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> 
參數 說明
ToUserName 員工UserID
FromUserName 企業號CorpID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：text
Content 文本消息內容
  • 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> 
參數 說明
ToUserName 員工UserID
FromUserName 企業號CorpID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：image
MediaId 圖片消息媒體id，可以調用多媒體文件下載接口拉取數據。
  • 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> 
參數 說明
ToUserName 員工UserID
FromUserName 企業號CorpID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：voice
MediaId 語音消息媒體id，可以調用多媒體文件下載接口拉取數據
  • 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> 
參數 說明
ToUserName 員工UserID
FromUserName 企業號CorpID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：video
MediaId 視頻消息媒體id，可以調用多媒體文件下載接口拉取數據。
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> 
參數 說明
ToUserName 員工UserID
FromUserName 企業號CorpID
CreateTime 消息創建時間（整型）
MsgType 消息類型，此時固定為：news
ArticleCount 多條圖文消息信息，默認***個item為大圖,注意，如果圖文數超過10，則將會無響應
Title 圖文消息標題
Description 圖文消息描述
PicUrl 圖片鏈接，支持JPG、PNG格式，較好的效果為大圖360*200，小圖200*200
Url 點擊圖文消息跳轉鏈接
責任編輯：閆佳明 來源： 51CTO
微信企業號開發接口
相關推薦

2014-09-24 11:32:21

微信企業號開發

2014-09-24 09:59:23

微信企業號開發

2013-11-13 00:14:16

微信微信公號微信公眾賬號

2014-09-24 10:29:14

微信企業號開發

2014-09-24 11:04:31

微信企業號開發

2014-09-24 11:45:15

微信企業號開發

2014-09-24 13:11:34

信企業號

2014-09-24 11:47:41

微信企業號開發

2013-11-13 00:37:12

微信微信公號微信公眾賬號

2014-09-25 15:48:51

微信企業號申請認證

2013-11-12 23:32:53

微信公號微信公眾賬號

2014-09-25 15:27:28

微信企業號注冊流程

2014-09-28 22:26:11

微信企業號

2014-09-24 11:52:37

微信企業號開發

2014-09-28 22:30:13

微信企業號

2014-10-21 15:42:30

微信企業號企業移動平臺

2013-11-13 00:20:01

微信微信公號微信公眾賬號

2013-11-13 01:25:33

微信微信公號微信公眾賬號

2014-09-25 13:40:52

微信企業號圖解

2014-09-28 22:38:21

微信企業號
點贊
收藏

51CTO技術棧公眾號

主站蜘蛛池模板： 欧美一级做a爰片免费视频 国产美女特级嫩嫩嫩bbb片 | 欧美一区二区三区在线看 | 伊人无码高清 | 久久久久久久香蕉 | 99视频在线| 99热在线免费 | 欧美在线a | 国产精品免费福利 | 天天看天天干 | 伊人欧美视频 | 黄网免费 | 久久久这里都是精品 | 国产高清久久久 | 精品视频久久久 | 亚洲欧美日韩精品久久亚洲区 | 成人国产精品久久 | 国产日产欧产精品精品推荐蛮挑 | 亚洲在线 | 黑人中文字幕一区二区三区 | 中文字幕一区二区三区四区 | 国产乱码精品一区二区三区中文 | 久热精品在线观看视频 | 成人h片在线观看 | 久久精品国产亚洲 | 成人a视频 | 91精品在线播放 | 久久久国产一区 | 紧缚调教一区二区三区视频 | 国产成人精品一区二区三区视频 | 日韩精品成人 | 中文字幕av在线播放 | 久久久久综合 | 欧美 视频 | 激情影院久久 | 国产一区二区三区视频 | 性国产xxxx乳高跟 | 日韩在线资源 | 久久国产精品视频观看 | 亚洲成人一区二区三区 | 春色av| 欧美日韩国产中文字幕 |