微信企業(yè)號(hào)開發(fā)之如何接收消息(1)
當(dāng)前位置:點(diǎn)晴教程→知識(shí)管理交流
→『 技術(shù)文檔交流 』
將應(yīng)用設(shè)置在回調(diào)模式時(shí),企業(yè)可以通過回調(diào)URL接收員工回復(fù)的消息,以及員工關(guān)注、點(diǎn)擊菜單、上報(bào)地理位置等事件。 在接收到事件后,企業(yè)可以發(fā)送被動(dòng)響應(yīng)消息,實(shí)現(xiàn)員工與企業(yè)的互動(dòng)。 注意,企業(yè)在接收消息,以及發(fā)送被動(dòng)響應(yīng)消息時(shí),消息體都以AES方式加密,以保證傳輸?shù)陌踩?。具體可參考'建立連接'中的'回調(diào)模式'一節(jié)。 一、關(guān)注與取消關(guān)注 員工在關(guān)注企業(yè)號(hào)時(shí),首先要與企業(yè)通訊錄中的帳號(hào)綁定;如果企業(yè)開啟了二次驗(yàn)證,那么在綁定成功后還需要經(jīng)過企業(yè)的驗(yàn)證,才可以關(guān)注成功。 1、員工與通訊錄中的帳號(hào)綁定 員工關(guān)注企業(yè)號(hào)時(shí),會(huì)根據(jù)員工的微信號(hào)、微信綁定的手機(jī)或郵箱,與企業(yè)通訊錄的帳號(hào)匹配。如果匹配到,則綁定成功;否則會(huì)提示員工輸入手機(jī)號(hào)或郵箱,驗(yàn)證成功后再與企業(yè)通訊錄中的帳號(hào)匹配。注意,員工的微信版本需要在5.4以上,目前僅支持iOS、Android兩個(gè)平臺(tái)。 2、二次驗(yàn)證 企業(yè)在開啟二次驗(yàn)證時(shí),必須填寫企業(yè)二次驗(yàn)證頁(yè)面的url。當(dāng)員工綁定通訊錄中的帳號(hào)后,會(huì)收到一條圖文消息,引導(dǎo)員工到企業(yè)的驗(yàn)證頁(yè)面驗(yàn)證身份,企業(yè)在員工驗(yàn)證成功后,調(diào)用如下接口即可讓員工關(guān)注成功。
Http請(qǐng)求方式: GET https://qyapi.weixin.qq.com/cgi-bin/user/authsucc?access_token=ACCESS_TOKEN&userid=USERID
管理員須擁有userid對(duì)應(yīng)員工的管理權(quán)限。
3、關(guān)注/取消關(guān)注事件的推送 員工關(guān)注、取消關(guān)注企業(yè)號(hào)的事件,會(huì)推送到每個(gè)應(yīng)用在管理端設(shè)置的URL;特別的,默認(rèn)企業(yè)小助手可以用于獲取整個(gè)企業(yè)號(hào)的關(guān)注狀況。(以下假設(shè)該URL為http://api.3dept.com)。
Http請(qǐng)求方式: POST http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=13500001234&nonce=123412323
二、接收普通消息 普通消息是指員工向企業(yè)號(hào)應(yīng)用發(fā)送的消息,包括文本、圖片、語(yǔ)音、視頻、地理位置等類型。
三、接收事件 事件是指員工在企業(yè)號(hào)上的某些操作行為,比如關(guān)注、上報(bào)地理位置、點(diǎn)擊菜單等。(關(guān)注事件請(qǐng)參考’關(guān)注與取消關(guān)注’) 1、菜單事件推送 員工點(diǎn)擊自定義菜單后,微信會(huì)把點(diǎn)擊事件推送給企業(yè)。請(qǐng)注意,點(diǎn)擊菜單彈出子菜單,不會(huì)產(chǎn)生上報(bào)。
2、上報(bào)地理位置事件 員工同意上報(bào)地理位置后,每次在進(jìn)入應(yīng)用會(huì)話時(shí)都會(huì)上報(bào)一次地理位置,或在進(jìn)入應(yīng)用會(huì)話后每5秒上報(bào)一次地理位置。企業(yè)可以在管理端修改應(yīng)用的以上 設(shè)置。上報(bào)地理位置時(shí),微信會(huì)將此事件推送到企業(yè)應(yīng)用在管理端設(shè)置的URL(以下假設(shè)該URL為http://api.3dept.com)。
Http請(qǐng)求方式: POST http://api.3dept.com/?signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=13500001234&nonce=123412323
四、被動(dòng)響應(yīng)消息 企業(yè)響應(yīng)的消息同樣應(yīng)該經(jīng)過加密,并帶上msg_signature、timestamp、nonce及密文,以下是標(biāo)準(zhǔn)的回包:
以下是各類型消息的明文XML結(jié)構(gòu):
該文章在 2014/12/2 0:45:08 編輯過 |
關(guān)鍵字查詢
相關(guān)文章
正在查詢... |