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/privacy）与使用条款（https://mokenlogic.com/zh/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 客户端。