範例:發送 Teams 通知

此篇文章將簡略教學如何透過 Microsoft Teams 整合 Webhook 發送工單通知。

1. 新增 Teams 連接器

首先需至 Teams 新增 webhook 功能來達成與系統內的溝通。以下將採用 Teams 的桌面應用程式來說明,其餘方式可參考 https://support.microsoft.com/zh-tw/teams 說明中心。

新增 Incoming WebHook

點擊左側選單 「… 」項目後,搜尋 Incoming WebHook 字樣並點擊 Incoming WebHook。

新增至目前團隊

點擊「新增至團隊」按鈕,並選擇你想要發送的團隊或頻道後,再點擊「設定連結器」。

輸入相關資訊

依序輸入WebHook 名稱等資訊後,再點擊「建立」新增。

最後,我們需要複製下列 URL,稍後將用於 FIRST LINE 內 Webhook 設定來發送通知。

2. 新增 Webhook 腳本

接著,需透過「Webhook 腳本」來呼叫 API 網址,所以前往左側選單中的 webhook 腳本設定並新增。

先依序將 webhook 基本資料設定

  • Webhook 名稱:輸入「Teams 工單通知」,可自行調整。

  • 呼叫網址:貼上稍早於 Teams 複製的 URL。

  • 請求方式:選擇 POST 方法。

  • 參數:輸入以下 JSON 格式,可依照所需傳輸資料調整,而訊息格式可參考 Office 365 Connectors API Reference

若您希望傳送自訂欄位等資訊,您可以使用 「czCol.欄位系統編號」 的方式,例如 czCol.34等,其中 34 代表自訂欄位的系統編號。您可以透過自訂欄位介面查閱相應的編號。需要注意的是,這種方法將來可能會被廢棄或更動,因此可能無法繼續使用。

{
  "title": "工單通知: {{ subject }}",
  "text": "{{ content }} 其他:{{ czCol.34 }}",
}

3. 新增自動化

最後,新增完成「發送 LINE 通知」Webhook 腳本後,並不會主動執行,所以我們需要透過「自動化」功能設定好想要的條件,並於「動作」中選擇此「Webhook」觸發。

而依據範例情境,當有專員人手建立優先度為緊急工單時,將發送通知於 Teams,故設定如下

  • 自動化名稱:輸入「緊急工單 Teams 通知」以利辨識。

  • 操作觸發來源:選擇「專員系統操作」項目。

  • 觸發指定事件時:選擇「資料建立時」項目,更新時將不會重複發送。

  • 符合特定條件:新增「優先度」並設定為「緊急」時才觸發。

  • 執行以下動作:選擇「執行 Webhook 腳本」並選擇上階段建立的「Teams 工單通知」。

現在,當客服人員建立緊急工單時,你所指定的 Teams 團隊或頻道將會收到來自 FIRST LINE 通知😊。

Last updated