企業(yè)微信開(kāi)發(fā)指南

企業(yè)微信的發(fā)展主要包括以下幾個(gè)方面：

微信官方在這些方面提供了非常詳細(xì)的文檔(見(jiàn)參考鏈接)，本文不再贅述。這里只選擇幾個(gè)常見(jiàn)的開(kāi)發(fā)場(chǎng)景來(lái)分享我自己的經(jīng)驗(yàn)。

部門(mén)通訊錄 員工組成，兩者關(guān)系多對(duì)多，部門(mén)有唯一的部門(mén)ID（department_id），員工有唯一的賬戶(hù)（userid）。

提供商有三種：

按作用分為兩種：

以下是一個(gè)應(yīng)用程序詳情界面：

從上圖可以看出，一個(gè)應(yīng)用程序主要包含以下信息：

訪(fǎng)問(wèn)令牌（access_token）這是我們開(kāi)發(fā)的第一步。在調(diào)用微信接口之前，我們經(jīng)常需要獲得令牌，然后才能為所欲為 :- )。

令牌只能通過(guò)企業(yè)ID（CorpID） Secret來(lái)獲取，CorpID檢查方法如下：

每個(gè)企業(yè)號(hào)CorpID但是Secret但是有幾種不同Secret獲得的令牌作用范圍不同。

Secret分類(lèi)如下：

獲取令牌的接口是：

返回格式如下：

需要注意的是access_token時(shí)效性超過(guò)7200（expires_in值)秒后過(guò)期，由于接口訪(fǎng)問(wèn)頻率有限，需要定期刷新access_token。

詳情請(qǐng)參考：獲取access_token - 企業(yè)微信。

這是我們使用頻率最高的場(chǎng)景。簡(jiǎn)單來(lái)說(shuō)，用戶(hù)進(jìn)入應(yīng)用時(shí)如何獲得他？userid(或更詳細(xì)的信息)？

授權(quán)登錄使用m.eeefficiency.com協(xié)議，先來(lái)看看微信官方提供的接入流程圖：

總結(jié)為三個(gè)步驟：

第一步和第二步都是為了得到code，第三步是獲取用戶(hù)信息。

假如我有一個(gè)主頁(yè)應(yīng)用程序，基本信息如下：

所以生成的網(wǎng)頁(yè)鏈接是這樣的(鏈接可以設(shè)置為主頁(yè)地址、菜單鏈接和推送消息的跳轉(zhuǎn)鏈接):

這里有兩點(diǎn)需要注意:

獲取用戶(hù)信息的接口是(注意)code只能用一次):

這里只討論一下Web網(wǎng)頁(yè)掃碼登錄場(chǎng)景，移動(dòng)掃碼登錄請(qǐng)參考官方文件。

在開(kāi)發(fā)掃碼登錄之前，您需要先打開(kāi)應(yīng)用程序的網(wǎng)頁(yè)接入功能，點(diǎn)擊應(yīng)用程序細(xì)節(jié)/企業(yè)微信授權(quán)登錄/Web網(wǎng)頁(yè)直接將可信域名的值 ** 過(guò)來(lái)設(shè)置。

掃碼登錄類(lèi)似于場(chǎng)景，也是m.eeefficiency.com先拿協(xié)議code交互流程圖如下：

假如我有以下基本信息：

所以生成的掃碼鏈接是這樣的:

用戶(hù)打開(kāi)鏈接后，會(huì)出現(xiàn)二維碼。用戶(hù)使用企業(yè)微信掃描代碼后，會(huì)跳轉(zhuǎn)到回調(diào)地址并帶授權(quán)code，通過(guò)code獲取用戶(hù)信息的接口為：

材料管理相對(duì)簡(jiǎn)單，可以直接呼叫微信接口，但需要注意的是，目前企業(yè)微信只開(kāi)放臨時(shí)材料管理接口（今天是微信），所有通過(guò)接口上傳media_id三天內(nèi)有效。

所以如果我需要永久性的話(huà)media_id咋整？這里分享一個(gè)“黑科技”。

比如要上傳圖片素材：

本質(zhì)上只是調(diào)用接口。

需要注意的是，消息都是以應(yīng)用為單位顯示的（在發(fā)送消息的時(shí)候會(huì)指定agentid），因此，您調(diào)用接口使用的接口access_token必須通過(guò)該應(yīng)用Secret獲得的。

如果你想排版消息(使用)html用戶(hù)點(diǎn)擊后，您希望跳轉(zhuǎn)到網(wǎng)頁(yè)地址，我推薦您使用文本卡消息。

我們以前也遇到過(guò)一個(gè)場(chǎng)景，希望用戶(hù)在點(diǎn)擊信息后跳轉(zhuǎn)到其他應(yīng)用程序，但不幸的是，微信不支持跨應(yīng)用程序跳轉(zhuǎn)。

要用JS-SDK，必須進(jìn)行客戶(hù)端SDK初始化；

要初始化，必須有簽名；

要有簽名，必須有簽名jsapi_ticket。

讓我們先談?wù)刯sapi_ticket。jsapi_ticket其實(shí)跟access_token同樣，它也會(huì)過(guò)期，并且有頻率限制，所以我們也需要jsapi_ticket定期刷新，獲取jsapi_ticket接口如下：

接下來(lái)是簽名，分享一個(gè)node簽名算法供參考：

如果您不確定您的算法是否正確，可以到微信提供的在線(xiàn)簽名工具進(jìn)行驗(yàn)證。

有了簽名，我們就可以了SDK初始化需要在初始化前引入js文件：

然后開(kāi)始實(shí)施初始化:

這里需要注意的是，所有參數(shù)對(duì)大小寫(xiě)都很敏感。例如，在后端簽名時(shí)，參數(shù)是noncestr，但是前端的初始化是nonceStr。

初始化成功后，你可以享受浪潮。使用企業(yè)微信打開(kāi)以下鏈接，體驗(yàn)官方提供的鏈接Demo頁(yè)面：

m.eeefficiency.com;(二維碼自動(dòng)識(shí)別)

上海西陸信息科技有限公司 承接各類(lèi)微信小程序開(kāi)發(fā)制作、小程序定制、APP 網(wǎng)站 開(kāi)發(fā)制作，聯(lián)系電話(huà) 18221533805、15900430334