建立工作流程:建立從 Slack 外部開始的工作流程

Webhook 功能可以讓你在 Slack 以外的位置開始工作流程,並且使用自訂變數將訊息張貼於含外部服務資訊的 Slack。

事前準備

  • 熟悉如何透過指令行或其他工具傳送 HTTP 請求。
  • 瞭解傳入的 Webhook。如需相關指引,請參閱 Slack API 說明文件,或向團隊中的開發人員求助。

注意:擁有者與管理員可以限制能夠以 Webhook 建立工作流程的人員。如果你沒有在「工作流程建立」中看到此選項,請向擁有者或管理員尋求協助。


工作流程設定

Webhook 工作流程基本資訊

選擇以 Webhook 開始工作流程時,就需設定讓 Webhook 在第三方應用程式或服務傳送網址網路請求時開始你的工作流程。例如,你可以建立一個工作流程,讓它在你的網站出現問題時,在特定頻道中張貼一則訊息,方便你的工程團隊展開調查。

設定 Webhook

你用於建立和設定 Webhook 的外部服務必須允許你在特定事件發生時向 Slack 提出 HTTP POST 請求。Slack 會在你發布工作流程之後產生工作流程專屬的請求網址,你可以將 Webhook 設定為在 HTTP 請求主體中向 Slack 傳遞資訊。透過建立變數的方式,Webhook 傳送給 Slack 的任何資料都可以供你新增至工作流程的步驟參照。

提示:如果您不確定該如何設定 Webhook,我們建議您向團隊中的開發人員尋求協助,或是參考目前使用之服務所提供的支援文件,例如 PostmanZapier

建立自訂變數

將資料從其他服務傳遞至 Slack,並在新增至工作流程的步驟中納入特定 Slack 資訊 (例如顯示名稱或電子郵件地址) 時,你最多可新增 20 個變數。

若要建立自訂變數,可以將一組成對的金鑰值新增到工作流程建立中的 Webhook 設定,方法是選取下列其中一種資料類型:頻道識別碼、使用者識別碼、使用者電子郵件,或者是文字。新增變數之後,你就會看見 HTTP 本文預覽內容。確認本文中的值確實符合你以 Webhook 連接到 Slack 的服務中的 JSON 輸出值。請留意,目前無法在工作流程變數中使用巢狀 JSON 結構。

在下方的例子中,如果使用者、嚴重性和 incident_description 沒有透過 Webhook 請求傳送,工作流程就無法啟動。

工作流程建立中的 Webhook 設定,顯示 Webhook 網址和自訂變數


取得網路請求網址

複製網路請求網址後,你可以將網址新增到 Webhook 中,確保它將你的 HTTP POST 傳送到正確的對話。請求網址的開頭一律是 https://hooks.slack.com/triggers,後面接著隨機出現的字元字串。

  1. 結束建立變數時,請按一下「完成」,然後按一下「繼續」,開始產生不重複的網路請求網址並返回工作流程建立。
  2. 按一下「Webhook 觸發」旁的「 鉛筆圖示」。 

請務必確保請求網址的安全,因為任何人都能透過這個連結開始你的工作流程。

注意:Webhook 工作流程會限制在每秒一個請求。請於 Slack API 網站深入瞭解速率限制


新增步驟以完成工作流程

新增步驟

設定 Webhook 並建立要使用的任何變數之後,就可以開始新增步驟至工作流程。 

  1. 在「工作流程建立」開啟工作流程。 
  2. 按一下「新增步驟」。 
  3. 選擇你要新增的步驟類型 (例如將訊息傳送至頻道)。然後按照提示自訂該步驟。
  4. 按一下「插入變數」,然後選取變數,在工作流程將傳送至頻道的訊息中加入 Webhook 傳來的資料。 


測試你的工作流程

結束工作流程之前,你可以設定張貼至測試頻道的第一個步驟。

  1. 傳送 POST 到工作流程的請求網址,並完成各個步驟以確認一切運作正常。
  2. 返回「工作流程建立」並更新工作流程的第一步驟,改成張貼至您選擇的頻道,接著再發布變更
誰可以使用此功能?

Related Articles

Recently Viewed Articles