企業(yè)微信API使用基本教程

在企業(yè)微信創(chuàng)建自建應用

1、登錄企業(yè)微信后臺，在“應用管理>自建”中點擊“創(chuàng)建應用”，填寫應用信息創(chuàng)建。

創(chuàng)建應用

API配置表參數(shù)值獲取

1、corpid:企業(yè)ID。在企業(yè)微信后臺的“我的企業(yè)>企業(yè)信息”中獲取。

獲取企業(yè)ID

2、corpsecret：應用憑證密匙。在自建應用詳情中獲取。

獲取應用憑證密匙

如果要使用通訊錄相關(guān)API則corpsecret在“管理工具>通訊錄同步”中獲取。

獲取通訊錄相關(guān)API

3、AesKey及token：加密的AES KEY和消息token。

如果是接收外部聯(lián)系人變更回調(diào)等事件信息，則在“自建應用詳情>接收消息>設置API接收”中獲取。

找到“設置API接收”

獲取

如果是接收通訊錄相關(guān)回調(diào)事件信息，則在“管理工具>通訊錄同步>設置接收事件服務器”中獲取。

通訊錄同步

設置接收事件服務器

獲取

云函數(shù)使用

1、根據(jù)企業(yè)微信API模板創(chuàng)建云函數(shù)

創(chuàng)建云函數(shù)

2、參照上文填寫配置參數(shù)。

填寫參數(shù)

3、在編程中編寫API?？墒褂?modules.wcworkApi調(diào)用部分已封裝API，使用$output輸出。

編寫API

鼠標移入可查看API說明。

查看API說明

4、保存測試。

編寫完成后，點擊右上方的保存按鈕保存代碼，并將此云函數(shù)開啟。

先1再2啊看清楚

在編程下方展開在線調(diào)試工具，點擊測試，查看運行結(jié)果。

測試

5、在功能中調(diào)用云函數(shù)。

確保云函數(shù)無誤開啟后，在功能中創(chuàng)建API步驟，選擇“自定義API”，再選擇對應云函數(shù)加以調(diào)用。

調(diào)用

Webhook使用

1、以與云函數(shù)類似的方式創(chuàng)建webhook，并配置相關(guān)參數(shù)。

配置參數(shù)

2、按照以下格式編寫代碼
async function hook($req, $resp, $modules = modules) { //get 請求用于驗證有效性if ($req.method == "GET") {//處理已封裝，可直接調(diào)用 $resp.body = await modules.wxworkApi.getVerifyMsg($req); } else if ($req.method == "POST") { //無法保證在五秒內(nèi)處理完成，先回復（企業(yè)微信服務器在五秒內(nèi)收不到響應會斷掉連接） $resp.body = "success"; //處理 let handle = async () => { //將數(shù)據(jù)轉(zhuǎn)換成json let data = await modules.wxworkApi.getMsgData($req); if (data.Event == "change_contact" && data.ChangeType == "create_party") { //TODO 處理添加部門事件 } } handle(); }}
3、保存代碼，復制webhook路徑。

保存后復制

4、在企業(yè)微信后臺的消息回調(diào)配置中（自建應用的API接收消息或通訊錄同步中的接收消息服務器設置）將復制的webhook路徑粘貼到url中。保存時將驗證有效性。

粘貼

5、在瀏覽器中直接打開webhook路徑應顯示“ok”。使用企業(yè)微信做相關(guān)操作觸發(fā)回調(diào)以檢測webhook處理結(jié)果。

測試

欧美日韩午夜_五月天激情综合_国产精品久久久久一区二区三区_色女人av_国产福利av_欧美日韩中

企業(yè)微信API使用基本教程