如何在 Teams Bot 中取得正確的 Group Id 及 Group Name

前言

在 Teams Bot 當使用者在 Group 中的 一般 或是其他的 Channel 跟 Bot 對話時，
Teams 傳給 Bot 內容中的 channelData 中，
會包含 tenantId(tenant.id) ，Group 一般 Channel 的 Id (team.id) 及 對話 Channel 的 Id(channel.id)，
那 Group Id 及 Group Name 要怎麼取得呢?

解決

使用者在 Group 中對話的內容如下，

{
  "text": "<at>rmdemobot</at> Hello message \n",
  "textFormat": "plain",
  "attachments": [
    {
      "contentType": "text/html",
      "content": "<div><div><span itemscope=\"\" itemtype=\"http://schema.skype.com/Mention\" itemid=\"0\">rmdemobot</span>&nbsp;Hello message </div>\n</div>"
    }
  ],
  "type": "message",
  "timestamp": "2023-06-21T01:44:55.8630554Z",
  "localTimestamp": "2023-06-21T09:44:55.8630554+08:00",
  "id": "1687311899999",
  "channelId": "msteams",
  "serviceUrl": "https://smba.trafficmanager.net/apac/",
  "from": {
    "id": "29:1iHtS5d7QQQXfCCCyQKseX3wABCDEaleHmZhuOpzoarz-LffABCDbcm0txhXMKK6O5oQQzRuKmSxmgm8No8SP9A",
    "name": "亂馬客",
    "aadObjectId": "23e66af0-3214-1234-1234-e3a6238d9999"
  },
  "conversation": {
    "isGroup": true,
    "conversationType": "channel",
    "tenantId": "d8183322-db35-6677-8866-bedc12345ee9",
    "id": "19:496c12345678904a5b46f495abcd471@thread.tacv2;messageid=1687311113113"
  },
  "recipient": {
    "id": "28:cb80ce17-9918-3366-1234-11540e123fa1",
    "name": "rmdemobot"
  },
  "entities": [
    {
      "mentioned": {
        "id": "28:cb80ce17-9918-3366-1234-11540e123fa1",
        "name": "rmdemobot"
      },
      "text": "<at>rmdemobot</at>",
      "type": "mention"
    }
  ],
  "channelData": {
    "teamsChannelId": "19:496c12345678904a5b46f495abcd471@thread.tacv2",
    "teamsTeamId": "19:NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1@thread.tacv2",
    "channel": {
      "id": "19:496c12345678904a5b46f495abcd471@thread.tacv2"
    },
    "team": {
      "id": "19:NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1@thread.tacv2"
    },
    "tenant": {
      "id": "d8183322-db35-6677-8866-bedc12345ee9"
    }
  },
  "locale": "zh-TW",
  "localTimezone": "Asia/Taipei"
}

網路上大多是在 Teams App 的 Group ... 上按右鍵，
按下 取得團隊的連結 中去 Parse Url 中的 groupId ，
https://teams.microsoft.com/l/team/19%NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1%40thread.tacv2/conversations?groupId=1f99kk99-1234-4c99-8125-abc186ade451&tenantId=d8183322-db35-6677-8866-bedc12345ee9
但在 Teams Bot 中，要怎麼取到那個 Group Id 及 Group Name 呢?

可以在 installationUpdate or conversationUpdate 事件中，
從 channelData 中的 team 來取得 Group 的資訊，
其中有 aadGroupId 、 name 及 Group 中一般 Channel 的 Id id 如下，

"channelData": {
    "settings": {
        "selectedChannel": {
            "id": "19:NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1@thread.tacv2"
        }
    },
    "channel": {
        "id": "19:NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1@thread.tacv2"
    },
    "team": {
        "aadGroupId": "1f99kk99-1234-4c99-8125-abc186ade451",
        "name": "myGroup",
        "id": "19:NyIXwHW0Wsa03IJPkvBuSiJX1kl5KK0Q1IyVD99abcQ1@thread.tacv2"
    },
    "tenant": {
        "id": "d8183322-db35-6677-8866-bedc12345ee9"
    },
    "source": {
        "name": "message"
    }
}

所以在 Bot 加到 Group 中，就先將這些資訊記錄下來，
從上面的 json 內容可以發現，使用 channelData 中的 team.id 就可以來對應哦~
所以，當使用者跟 Bot 對話時，就可以用 channelData 中的 team.id 來對應它，
取出 team.aadGroupId 取 team.name 哦~

參考資源

Have a conversation with a Microsoft Teams bot
Conversation events in your Teams bot