> For the complete documentation index, see [llms.txt](https://help.firstline.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.firstline.cc/feature/integrate/automation/ms-teams.md).

# 範例：發送 Teams 通知

## 1. 新增 Teams 連接器

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

### 新增 **Incoming WebHook**

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

<div align="center"><img src="/files/-MlETiya7jwCQcLcJxiI" alt=""></div>

### 新增至目前團隊

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

![](/files/-MlETzXSqFmJHmXo-ilo)

### 輸入相關資訊

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

![](/files/-MlEVD3YpYN5zeGkFvLH)

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

![](/files/-MlEVx5Ff44xUGxvUfEK)

## 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 }}",
}
```

![](/files/-MlEXo-n_-90uCkAOYlN)

## 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 工單通知」。

![](/files/-MlEZHkgBmwpguiSPix7)

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

![](/files/-MlEaesfSc3IAn8CVI4Y)
