企業微信API使用基本教程

在企業微信創建自建應用

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

創建應用

API配置表參數值獲取

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

獲取企業ID

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

獲取應用憑證密匙

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

獲取通訊錄相關API

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

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

找到“設置API接收”

獲取

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

通訊錄同步

設置接收事件服務器

獲取

云函數使用

1、根據企業微信API模板創建云函數

創建云函數

2、參照上文填寫配置參數。

填寫參數

3、在編程中編寫API。可使用$modules.wcworkApi調用部分已封裝API，使用$output輸出。

編寫API

鼠標移入可查看API說明。

查看API說明

4、保存測試。

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

先1再2啊看清楚

在編程下方展開在線調試工具，點擊測試，查看運行結果。

測試

5、在功能中調用云函數。

確保云函數無誤開啟后，在功能中創建API步驟，選擇“自定義API”，再選擇對應云函數加以調用。

調用

Webhook使用

1、以與云函數類似的方式創建webhook，并配置相關參數。

配置參數

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

保存后復制

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

粘貼

5、在瀏覽器中直接打開webhook路徑應顯示“ok”。使用企業微信做相關操作觸發回調以檢測webhook處理結果。

測試

欧美深夜视频_国产精品99视频_国产精品网站一区_亚洲最大av网

企業微信API使用基本教程