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

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

微信官方在這些方面提供了非常詳細的文檔(見參考鏈接)，本文不再贅述。這里只選擇幾個常見的開發(fā)場景來分享我自己的經(jīng)驗。

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

提供商有三種：

按作用分為兩種：

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

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

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

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

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

Secret分類如下：

獲取令牌的接口是：

返回格式如下：

需要注意的是access_token時效性超過7200（expires_in值)秒后過期，由于接口訪問頻率有限，需要定期刷新access_token。

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

這是我們使用頻率最高的場景。簡單來說，用戶進入應(yīng)用時如何獲得他？userid(或更詳細的信息)？

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

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

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

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

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

這里有兩點需要注意:

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

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

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

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

假如我有以下基本信息：

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

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

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

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

比如要上傳圖片素材：

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

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

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

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

要用JS-SDK，必須進行客戶端SDK初始化；

要初始化，必須有簽名；

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

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

接下來是簽名，分享一個node簽名算法供參考：

如果您不確定您的算法是否正確，可以到微信提供的在線簽名工具進行驗證。

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

然后開始實施初始化:

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

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

m.eeefficiency.com;(二維碼自動識別)

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