在企業微信創建自建應用
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處理結果。
測試