企業微信開發指南

2022-10-05

企業微信的發展(zhan)主要(yao)包括以下(xia)幾(ji)個方面：

微信官方在這(zhe)些方面提供了非常詳細(xi)的文檔(見(jian)參考鏈接(jie))，本文不再贅述。這(zhe)里只選(xuan)擇幾個(ge)常見(jian)的開發場景(jing)來(lai)分享我自己的經(jing)驗。

部門(men)通訊錄員工(gong)組(zu)成，兩(liang)者關系多對多，部門(men)有(you)唯一的(de)(de)部門(men)ID（department_id），員工(gong)有(you)唯一的(de)(de)賬(zhang)戶（userid）。

提供商有三種：

按作用分為兩種：

以下是一個應用程序(xu)詳情(qing)界面：

從上圖可以(yi)看(kan)出(chu)，一個應用程序主要包(bao)含以(yi)下信息：

訪問(wen)令(ling)牌（access_token）這(zhe)是我(wo)們(men)開發的第一步(bu)。在調用微信(xin)接(jie)口之前，我(wo)們(men)經常需要獲(huo)得(de)令(ling)牌，然后才(cai)能為(wei)所(suo)欲(yu)為(wei) :- )。

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

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

Secret分類如下：

獲取令牌的接口是：

返回格式如下：

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

詳情請參考：獲取access_token - 企業微信。

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

授(shou)權登錄(lu)使用(yong)karrylady.cn協(xie)議，先來看看微信(xin)官(guan)方提供的接(jie)入流程圖：

總結為三個步驟：

第(di)一步(bu)和(he)第(di)二(er)步(bu)都(dou)是(shi)為了得到code，第(di)三(san)步(bu)是(shi)獲取用戶信息。

假如(ru)我(wo)有一個主頁應用程序，基本信(xin)息如(ru)下：

所以生成的(de)網頁(ye)(ye)鏈(lian)接是(shi)這樣的(de)(鏈(lian)接可以設置為主頁(ye)(ye)地址、菜單鏈(lian)接和推(tui)送消息(xi)的(de)跳轉鏈(lian)接):

這里有(you)兩點需(xu)要注意:

獲(huo)取(qu)用(yong)戶信息的接(jie)口是(注(zhu)意)code只(zhi)能用(yong)一次):

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

在開發掃(sao)碼登錄之前，您(nin)需要先打開應用程(cheng)序的網頁接入功能(neng)，點擊應用程(cheng)序細節/企業微信授權登錄/Web網頁直接將可信域名的值 ** 過來設置。

掃碼登錄類(lei)似于場景，也是karrylady.cn先(xian)拿協議code交互流程圖如下：

假如我有以(yi)下(xia)基本信息：

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

用(yong)戶打開(kai)鏈接(jie)后(hou)，會出現二維碼。用(yong)戶使用(yong)企業微信掃描代(dai)碼后(hou)，會跳轉到(dao)回調(diao)地(di)址并帶授權code，通過code獲取用(yong)戶信息的接(jie)口為：

材料管理(li)相對簡(jian)單(dan)，可以直(zhi)接(jie)呼叫微(wei)信接(jie)口(kou)，但需要注意的是，目前企業(ye)微(wei)信只(zhi)開放臨時材料管理(li)接(jie)口(kou)（今天(tian)是微(wei)信），所有(you)通過接(jie)口(kou)上傳media_id三天(tian)內(nei)有(you)效。

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

比如要上傳圖片(pian)素材：

本質上只是調用接口(kou)。

需要注意的(de)(de)是，消息(xi)都是以應(ying)用(yong)(yong)為單位顯示的(de)(de)（在發送消息(xi)的(de)(de)時候會指定agentid），因此，您調用(yong)(yong)接(jie)口使用(yong)(yong)的(de)(de)接(jie)口access_token必須通過該(gai)應(ying)用(yong)(yong)Secret獲得的(de)(de)。

如果你(ni)想(xiang)排版消(xiao)息(使用)html用戶點擊后，您(nin)希望跳轉到網頁(ye)地址，我(wo)推薦您(nin)使用文本卡消(xiao)息。

我(wo)們以前也遇到(dao)過一(yi)個場景，希望用(yong)戶(hu)在(zai)點(dian)擊信息后跳轉到(dao)其他應(ying)用(yong)程序，但不幸的是，微信不支持跨應(ying)用(yong)程序跳轉。

要用JS-SDK，必須(xu)進行客(ke)戶端SDK初始(shi)化；

要初始(shi)化，必須有簽名；

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

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

接(jie)下來是簽(qian)(qian)名，分享一個node簽(qian)(qian)名算法供參考(kao)：

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

有了簽名(ming)，我們就可以(yi)了SDK初始(shi)化需要(yao)在初始(shi)化前引入js文(wen)件：

然后(hou)開始(shi)(shi)實施初(chu)始(shi)(shi)化:

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

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