botframework - 如何通过 REST API 为连接到 Microsoft Teams channel 的机器人获取机器人 ID 和用户 ID

Question

我们使用 Microsoft bot 框架，并且需要通过 REST API 从外部应用程序(在不同的环境中运行，例如内部部署)向连接到 Microsoft Teams channel 的机器人发送消息.以下 REST API 有助于创建对话

• 应用程序接口(interface):https://smba.trafficmanager.net/amer/v3/conversations
• 授权:不记名 token (使用的 token 端点: https://login.microsoftonline.com/botframework.com/oauth2/v2.0/token )
• POST 请求正文在这里:

{
    "bot": {
        "name": "someBot",
        "id": "xxx-some-bot-id"
    },
    "members": [
        {
            "name": "some user",
            "id": "xxx-some-user-id"
        }
    ],
  "channelData": {
    "tenant": {
      "id": "xxx-some-teanant-id"
    }
  },
}

此 API 返回的 ID 稍后可用于通过 /v3/conversations/{id} 发送消息

这里有几个问题:

1. 是否有任何 REST API 可用于获取成员 ID(用户 ID)和 上述有效负载中使用的机器人 ID？换句话说，外部应用程序如何读取这两个内部Id以供使用进行 API 调用？在 Bot API 中找不到合适的 API文档页面:Bot Framework REST API

2. 有没有办法让租户 id 通过 REST API 以及上述情况？ (我知道它可以从 Teams 应用程序 URL 中读取)

谢谢

Answer 1

基本上不能，您无法从 Teams 外部检索 ID(出于隐私/垃圾邮件预防原因)。您的机器人可以通过几种方式接收它们:

• 在个人环境中安装时，您的机器人将收到 membersAdded 类型的消息，其中包含必要的信息。

• 如果您的机器人安装在该人员所属的团队中，您可以检索该团队的花名册，其中也包含必要的信息。

参见:https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/conversations/send-proactive-messages