範例:發送 Teams 通知
此篇文章將簡略教學如何透過 Microsoft Teams 整合 Webhook 發送工單通知。
Last updated
此篇文章將簡略教學如何透過 Microsoft Teams 整合 Webhook 發送工單通知。
Last updated
首先需至 Teams 新增 webhook 功能來達成與系統內的溝通。以下將採用 Teams 的桌面應用程式來說明,其餘方式可參考 https://support.microsoft.com/zh-tw/teams 說明中心。
點擊左側選單 「… 」項目後,搜尋 Incoming WebHook 字樣並點擊 Incoming WebHook。
點擊「新增至團隊」按鈕,並選擇你想要發送的團隊或頻道後,再點擊「設定連結器」。
依序輸入WebHook 名稱等資訊後,再點擊「建立」新增。
最後,我們需要複製下列 URL,稍後將用於 FIRST LINE 內 Webhook 設定來發送通知。
接著,需透過「Webhook 腳本」來呼叫 API 網址,所以前往左側選單中的 webhook 腳本設定並新增。
先依序將 webhook 基本資料設定
Webhook 名稱:輸入「Teams 工單通知」,可自行調整。
呼叫網址:貼上稍早於 Teams 複製的 URL。
請求方式:選擇 POST 方法。
參數:輸入以下 JSON 格式,可依照所需傳輸資料調整,而訊息格式可參考 Office 365 Connectors API Reference。
若您希望傳送自訂欄位等資訊,您可以使用 「czCol.欄位系統編號」 的方式,例如 czCol.34等,其中 34 代表自訂欄位的系統編號。您可以透過自訂欄位介面查閱相應的編號。需要注意的是,這種方法將來可能會被廢棄或更動,因此可能無法繼續使用。
最後,新增完成「發送 LINE 通知」Webhook 腳本後,並不會主動執行,所以我們需要透過「自動化」功能設定好想要的條件,並於「動作」中選擇此「Webhook」觸發。
而依據範例情境,當有專員人手建立優先度為緊急工單時,將發送通知於 Teams,故設定如下
自動化名稱:輸入「緊急工單 Teams 通知」以利辨識。
操作觸發來源:選擇「專員系統操作」項目。
觸發指定事件時:選擇「資料建立時」項目,更新時將不會重複發送。
符合特定條件:新增「優先度」並設定為「緊急」時才觸發。
執行以下動作:選擇「執行 Webhook 腳本」並選擇上階段建立的「Teams 工單通知」。
現在,當客服人員建立緊急工單時,你所指定的 Teams 團隊或頻道將會收到來自 FIRST LINE 通知😊。