# 範例：發送 Teams 通知

## 1. 新增 Teams 連接器

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

### 新增 **Incoming WebHook**

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

<div align="center"><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlERILJmDrD7_LHfRQX%2F-MlETiya7jwCQcLcJxiI%2F%E6%88%AA%E5%9C%96%202021-10-05%2014.49.02.png?alt=media&#x26;token=21e1421b-5964-41e7-989c-36c84c96628c" alt=""></div>

### 新增至目前團隊

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

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlERILJmDrD7_LHfRQX%2F-MlETzXSqFmJHmXo-ilo%2F%E6%88%AA%E5%9C%96%202021-10-05%2014.50.49.png?alt=media\&token=ccf49f28-9575-499f-824c-fbaf951e9731)

### 輸入相關資訊

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

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlEV5SAfKb_3pFrZBFt%2F-MlEVD3YpYN5zeGkFvLH%2F%E6%88%AA%E5%9C%96%202021-10-05%2014.57.04.png?alt=media\&token=78c527f9-7637-458e-adb5-c6b0b2ebf3d3)

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

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlEV5SAfKb_3pFrZBFt%2F-MlEVx5Ff44xUGxvUfEK%2F%E6%88%AA%E5%9C%96%202021-10-05%2016.12.25.png?alt=media\&token=d67c81e6-c4b1-47bb-a925-882b1709c2bf)

## 2. 新增 Webhook 腳本

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

先依序將 webhook 基本資料設定

* Webhook 名稱：輸入「Teams 工單通知」，可自行調整。
* 呼叫網址：貼上稍早於 Teams 複製的 URL。
* 請求方式：選擇 POST 方法。
* 參數：輸入以下 JSON 格式，可依照所需傳輸資料調整，而訊息格式可參考 [Office 365 Connectors API Reference](https://dev.outlook.com/connectors/reference)。

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

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

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlEWBmwqh4keTlFV1yP%2F-MlEXo-n_-90uCkAOYlN%2F%E6%88%AA%E5%9C%96%202021-10-05%2016.21.32.png?alt=media\&token=391388e1-2752-4243-97b4-09a02695425f)

## 3. 新增自動化 <a href="#id-3-xin-zeng-zi-dong-hua" id="id-3-xin-zeng-zi-dong-hua"></a>

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

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

* 自動化名稱：輸入「緊急工單 Teams 通知」以利辨識。
* 操作觸發來源：選擇「專員系統操作」項目。
* 觸發指定事件時：選擇「資料建立時」項目，更新時將不會重複發送。
* 符合特定條件：新增「優先度」並設定為「緊急」時才觸發。
* 執行以下動作：選擇「執行 Webhook 腳本」並選擇上階段建立的「Teams 工單通知」。

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlEZ0bx3w7PmUkNxMB-%2F-MlEZHkgBmwpguiSPix7%2F%E6%88%AA%E5%9C%96%202021-10-05%2016.27.54.png?alt=media\&token=20730dcb-7e6f-4e6e-87c3-65b1240ffece)

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

![](https://842546780-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNRu7dk70ei7JV9HlW9%2F-MlE_sLhorka7i5uqd3l%2F-MlEaesfSc3IAn8CVI4Y%2F%E6%88%AA%E5%9C%96%202021-10-05%2016.38.02.png?alt=media\&token=817a8140-5044-4f15-8710-d8fcf65c30e4)