建立工作流程:建立從 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. 返回「工作流程建立」並更新工作流程的第一步驟,改成張貼至您選擇的頻道,接著再發布變更
誰可以使用此功能?