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

2022-10-05

企業(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），員工有唯一的賬戶（userid）。

提供商有三種：

按作用分為兩種：

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

從上圖可以看出，一個(gè)應(yī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ò)期，由于接口訪問(wèn)頻率有限，需要定期刷新access_token。

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

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

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

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

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

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

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

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

獲取用戶信息的接口是(注意)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)景，也是www.beitangfood.com先拿協(xié)議code交互流程圖如下：

假如我有以下基本信息：

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

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

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

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

比如要上傳圖片素材：

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

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

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

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

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