EventBridge：DingTalk新增成員資訊自動觸發HTTP API業務介面

流程介紹

本文使用的方案涉及到DingTalk、DingTalk連接器、事件匯流排EventBridge、Function Compute等產品，流程如下圖所示：

前提條件

步驟一：建立自訂事件匯流排

1. 登入事件匯流排EventBridge控制台，在頂部功能表列，選擇地區。
2. 在左側導覽列，單擊事件匯流排，在自訂事件匯流排地區，單擊快速建立。
3. 在建立自訂事件匯流排面板，完成以下操作。
   1. 在匯流排頁簽，設定自訂事件匯流排名稱和描述，然後單擊下一步。
   2. 在事件來源頁簽，設定事件來源名稱和描述，配置以下參數，然後單擊下一步。

      參數	值
      事件提供方	HTTP/HTTPS觸發
      請求類型	HTTPS
      要求方法	POST
      安全配置	無需配置

   3. 在規則頁簽，單擊跳過，然後在直接创建自定义事件总线對話方塊單擊確認，暫不在新建立的自訂事件匯流排上建立事件規則和事件目標。
      建立完成後，您可以在事件來源列表找到剛才建立的自訂事件來源，然後單擊詳情查看配置資訊。其中公網請求 URL可以作為DingTalk連接器的接入Webhook地址。

步驟二：建立DingTalk串連流

1. 登入DingTalk開放平台，在頂部功能表列選擇開放能力 > 串連平台。
2. 在左側導覽列選擇我的串連 > 串連流。
3. 在我的串連流頁面，從建立列表中，選擇業務流。
   1. 在建立流對話方塊，設定業務流的名稱和描述，設定觸發器為官方 > 通訊錄 > 通訊錄使用者增加。
   2. 在串連流頁簽，單擊表徵圖，然後單擊網路請求。
   3. 在網路請求地區右側，單擊表徵圖，然後在網路請求面板佈建要求參數，單擊儲存。

      參數	說明	樣本
      請求方式	與步驟一：建立自訂事件匯流排中配置的要求方法一致。	POST
      請求地址	配置步驟一：建立自訂事件匯流排中擷取的URL地址。	https://115964845466****.eventbridge.cn-hangzhou.aliyuncs.com/webhook/putEvents?token=8a5c4e6****
      Body	訊息體包含的欄位。	root

步驟三：使用Function Compute調用HTTP API

1. 登入Function Compute控制台，在左側導覽列，單擊服務及函數。
2. 在頂部功能表列，選擇地區，然後在服務列表頁面，單擊建立服務。
3. 在建立服務面板，填寫服務名稱和描述，並按需設定以下配置項，然後單擊確定。

   配置項	說明
   日誌功能	是否啟用阿里雲Log Service。取值說明如下： 啟用：函數的執行日誌被持久化儲存到Log Service，方便您代碼調試、故障分析和資料分析等。 禁用：函數的執行日誌將無法通過Log Service儲存和查詢。
   進階配置
   鏈路追蹤功能	是否啟用阿里雲鏈路追蹤功能。取值說明如下： 啟用：您可以使用Jaeger上傳鏈路資訊，來跟蹤函數的執行，快速分析和診斷Serverless架構下的效能瓶頸。更多資訊，請參見鏈路追蹤簡介。 禁用：不啟用鏈路追蹤功能。
   服務角色	佈建服務中函數所使用的角色，使函數可以獲得角色所擁有的許可權。更多資訊，請參見授予Function Compute訪問其他雲端服務的許可權。
   允許訪問 VPC	是否允許函數訪問VPC內資源。更多資訊，請參見配置網路。
   專用網路	允許訪問 VPC選擇是時必填。建立新的VPC或在下拉式清單中選擇要訪問的VPC ID。
   交換器	允許訪問 VPC選擇是時必填。建立新的交換器或在下拉式清單中選擇交換器ID。
   安全性群組	允許訪問 VPC選擇是時必填。建立新的安全性群組或在下拉式清單中選擇安全性群組。
   允許函數訪問公網	是否允許函數訪問公網。關閉後，當前服務中的函數將無法通過Function Compute的預設網卡訪問公網。 重要 使用固定公網IP地址功能時，您必須關閉允許函數訪問公網，否則配置的固定公網IP地址不生效。更多資訊，請參見配置固定公網IP地址。

4. 在服務列表頁面，單擊目標服務名稱，然後單擊建立函數。
5. 在建立函數頁面，按需選擇建立函數的方式，配置以下配置項，然後單擊建立。
   1. 在基本設定地區，設定函數名稱，選擇請求處理常式類型為處理 HTTP 要求。
   2. 在函數代碼地區，選擇運行環境為Node.js，選擇代碼上傳方式為使用範例程式碼，並單擊API Gateway觸發函數。
      
   建立完成後，可在函數詳情頁面查看詳情。

步驟四：建立事件規則

1. 登入事件匯流排EventBridge控制台，找到步驟一：建立自訂事件匯流排中建立的自訂事件匯流排。
2. 單擊自訂事件匯流排名稱，然後在左側功能表列，單擊事件規則。
3. 在事件規則頁面，單擊建立規則，然後在建立規則設定精靈，配置以下參數。
   1. 在配置基本資料頁簽，設定事件規則的名稱和描述，然後單擊下一步。
   2. 在配置事件模式頁簽，設定事件來源類型為自訂事件來源，設定事件來源為步驟一：建立自訂事件匯流排中建立的自訂事件來源，然後單擊下一步。
   3. 在配置事件目標頁簽，設定以下參數，然後單擊建立。

      參數	說明	樣本
      服務類型	選擇目標服務類型。	Function Compute
      服務	選擇步驟三：使用Function Compute調用HTTP API中建立的服務。	testserver
      函數	配置步驟三：使用Function Compute調用HTTP API中建立的函數。	testfunction
      事件	選擇完整事件。	完整事件
      執行方式	選擇同步。	同步

步驟五：新增員工事件自動觸發HTTP API

1. 邀請成員加入您的DingTalk團隊。詳細操作，請參見如何添加組織成員。
2. 在步驟一：建立自訂事件匯流排中建立的自訂事件匯流排詳情頁面，單擊事件追蹤，設定查詢時間範圍，單擊查詢。
3. 在查詢到的事件右側操作列，單擊事件軌跡，查看新增員工事件已經成功被投遞。
   

結果驗證

登入Function Compute控制台，在步驟三：使用Function Compute調用HTTP API中建立的函數詳情頁面，單擊函數日誌頁簽查看日誌。