Microsoft Teams 整合設定指南

建立機器人（Bot）

打開 Teams 開發人員入口網站（https://dev.teams.microsoft.com/），進入「Tools → Bot management」，點選「New bot」，填寫名稱（例如「Moken」），點選「Add」。建立後會顯示 Bot ID，請記下它，後續在 MokenLogic 中註冊時需要用到。

將機器人端點指向 MokenLogic

打開剛建立的機器人，進入「Configure」，將端點位址（Endpoint address）設定為下方的 MokenLogic Teams 端點，點選「Save」：https://api.mokenlogic.com/api/v1/channels/teams/events

建立用戶端密鑰（Client secret）

進入「Client secrets」分頁，點選「Add a secret」，複製產生的密鑰。下一步將作為 App Password 填入 MokenLogic。

密鑰僅顯示一次，請立即複製並妥善保存；如遺失需重新建立。

在 MokenLogic 中註冊機器人

打開 MokenLogic，進入「能力 → 連接器」，在「Microsoft Teams」分組點選「新增機器人」。將 Bot ID 填入 App ID、用戶端密鑰填入 App Password，可選填顯示名稱，點選「註冊機器人」。註冊成功後，MokenLogic 將使用這組憑證收發 Teams 訊息。可隨時回到「連接器」頁面查看連線狀態或移除機器人。

建立應用程式（App）

回到 Teams 開發人員入口網站，進入「Apps」，點選「New app」，填寫應用程式名稱，資訊清單版本保持最新穩定版，點選「Add」。這個應用程式是讓使用者在 Teams 中安裝機器人的安裝包。

填寫基本資訊

在應用程式的「Basic information」頁面填寫簡短名稱與簡短/詳細描述。此處的 App ID 由 Microsoft 產生，在你的組織內為唯一值。

填寫開發人員資訊與 URL

向下捲動到「Developer information」與「App URLs」，填寫開發人員/公司名稱、網站，以及隱私權政策和使用條款的 URL，點選「Save」。例如可使用 MokenLogic 自己的隱私權政策（https://mokenlogic.com/zh-hant/privacy）與使用條款（https://mokenlogic.com/zh-hant/terms）。

上傳應用程式圖示

進入「Branding」，上傳兩個圖示：彩色圖示（192×192 像素 PNG，中心含 96×96 圖形）和描邊圖示（32×32 像素，白色或透明）。

新增 Bot 功能

打開「App features」，在「Select a feature to add」中選擇「Bot」。

選擇 Bot 並設定可用範圍

在「Identify your bot」下選擇「Select an existing bot」，選取第 1 步建立的機器人。然後在「Select the scopes where people can use your bot」中勾選「Personal」和「Group Chat」，點選「Save」。

在 Teams 中預覽

點選右上角的「Preview in Teams」，即可將應用程式安裝到你的 Teams 用戶端。