Microsoft Teams
===
###### tags: `GSS` `LDL`
## 1.使用Microsoft Teams

(1) 需要建立一個 Teams Bot

* [建立 Teams Bot 頁面](https://dev.botframework.com/bots/new)


點擊 Create Microsoft App ID and pasword 會到下面這個頁面


點擊左上角的 New registration 註冊您的 bot!


在 Name 欄位輸入 bot 的名稱

下方記得選取第三個選項
**Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)**

註冊完成後把 **Application (client) ID** 跟 **Directory (tenant) ID** 記錄下來

再來是在 Certificates & secrets 頁面 新增一個新的 client secrets 並記錄下來


(2) 回去[建立 Teams Bot 頁面](https://dev.botframework.com/bots/new)把 App ID 貼上去並儲存設定

(3) 透過後台管理介面 或 Bot 管理 API 新增一個 Bot Channel

(4) 註冊 Facebook Channel 所需要的設定

* clientId - `步驟1` 取得的 Application (client) ID
* clientSecret - `步驟1` 取得的 client secrets
* tenantId - `步驟1` 取得的 Directory (tenant) ID

{
    ...,
    "channelHook": {
        "msteams": {
            "clientId":"",
            "clientSecret":"",
            "tenantId":""
        }
    }
}

## 2.Facebook Messenger 的使用限制
#### (1) 訊息格式的轉換

| Bot Framework Message | Facebook Messenger |
| --------------------- | ----------------------------------------- |
| Text | Text |
| Suggested Action | Quick Reply Message |
| Image | Image |
| Audio | Audio (尚未支援) |
| Video | Video |
| Hero Card | Template Message |
| Thumbnail Card | Template Message |
| SignIn Card | Template Message |
| Receipt Card | Template Message |
| Animation Card | N/A |
| Audio Card | N/A |
| Video Card | Media Template |
| Adaptive Card | N/A |

註：Template Message 需要放在 channel data 中

#### (2) 一般訊息的限制 (文字、圖片、聲音、影像)

* **文字** (Text Message)
* text 最多 **320** 個字
* **圖片** (Image Message，包含 Animation Card 的 Image)
* 圖片連結必須是有效的
* 支援的圖片格式是 **jpg**、**png**
* Url 字數沒有限定，支援的協定：HTTP、HTTPS
* 最大支援 25MB 的照片

#### (3) 卡片格式的限制 (使用 Template Message)

* 可以在桌機版和手機版上看到卡片內容
* 格式限制比Template Message 寬鬆許多
* **文字**
* title 和 subtitle 最多 **80** 個字
* text 最多 **320** 個字
* **圖片**
* 支援的圖片格式是 **jpg**、**png**
* Url 字數沒有限定，支援的協定：HTTP、HTTPS
* 最大支援 25MB 的照片
* **按鈕數量**
* 一張卡片按鈕數量最多3個
* **按鈕 Action**
* Postback Action (Postback)
* Button Label 最多 **640** 個字
* payload 最多 **1000** 個字
* URL Action (OpenUrl)
* Button Label 最多 **20** 個字
* Url 字數沒有限定，支援的協定：HTTP、HTTPS
* **Gallery** (多個卡片橫向擺置)
* 最多可以容納10張卡片

* 詳細可以查看[Facebook Messenger官方文件](https://developers.facebook.com/docs/messenger-platform/reference)

註：由於 facebook 一張卡片最多只能放一張照片和三個按鈕，若是傳送過來的卡片超過一張照片或三張按鈕，會把卡片向右延伸，如果照片不夠使用，會使用最後一張的照片，若按鈕不夠，會使用最後一張卡片的按鈕

#### (4) Quick Reply Message

* 支援以下按鈕 Action，最多13個按鈕
* Postback Action (Postback)
* URL Action (OpenUrl)

#### (5) 其他限制

* Facebook Messenger 不支援 `Adaptive Card`
* 如果想要自定 Template Message 內容，請參考 [官方文件](https://developers.facebook.com/docs/messenger-platform/send-messages/templates)