Update get-teams-context.md

Author: Pranjal-MSFT

msteams-platform/bots/how-to/get-teams-context.md

@@ -4,7 +4,7 @@ description: Get Teams specific context for your bot, fetch user profile, get si
 ms.topic: conceptual
 ms.localizationpriority: high
 ms.owner: angovil
-ms.date: 03/16/2026
+ms.date: 03/24/2026
 ---
 # Get Teams specific context for your bot
 
@@ -30,23 +30,13 @@ The following sample code uses the paged endpoint for fetching the roster:
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-proactive-installation/csharp/ProactiveAppInstallation/Bots/ProactiveBot.cs#L78)
 
 ```csharp
-public class MyBot : TeamsActivityHandler
+app.OnMessage(async context =>
 {
-    protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
-    {
-        var members = new List<TeamsChannelAccount>();
-        string continuationToken = null;
-
-        do
-        {   
-            // Gets a paginated list of members of one-on-one, group, or team conversation.
-            var currentPage = await TeamsInfo.GetPagedMembersAsync(turnContext, 100, continuationToken, cancellationToken);
-            continuationToken = currentPage.ContinuationToken;
-            members.AddRange(currentPage.Members);
-         }
-         while (continuationToken != null);
-     }
-}
+    var conversationId = context.Activity.Conversation.Id;
+
+    // Gets all members of the conversation.
+    var members = await context.Api.Conversations.Members.GetAsync(conversationId);
+});
 ```
 
 # [TypeScript](#tab/typescript)
@@ -56,40 +46,25 @@ public class MyBot : TeamsActivityHandler
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-proactive-installation/nodejs/bots/proactiveBot.js#L38)
 
 ```typescript
-export class MyBot extends TeamsActivityHandler {
-    constructor() {
-        super();
-
-        // See https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0 to learn more about the message and other activity types.
-        this.onMessage(async (turnContext, next) => {
-            var continuationToken;
-            var members = [];
-
-            do {
-                // Gets a paginated list of members of one-on-one, group, or team conversation.
-                var pagedMembers = await TeamsInfo.getPagedMembers(turnContext, 100, continuationToken);
-                continuationToken = pagedMembers.continuationToken;
-                members.push(...pagedMembers.members);
-            }
-            while(continuationToken !== undefined)
-
-            // By calling next() you ensure that the next BotHandler is run.
-            await next();
-        });
-    }
-}
+app.on('message', async ({ activity, api }) => {
+    const conversationId = activity.conversation.id;
+
+    // Gets all members of the conversation.
+    const members = await api.conversations.members(conversationId).get();
+});
 ```
 
 # [Python](#tab/python)
 
 [SDK reference](/python/api/botbuilder-core/botbuilder.core.teams.teamsinfo?view=botbuilder-py-latest&preserve-view=true#botbuilder-core-teams-teamsinfo-get-team-members)
 
 ```python
-async def _show_members(
-    self, turn_context: TurnContext
-):
-    # Get a conversationMember from a team.
-    members = await TeamsInfo.get_team_members(turn_context)
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    conversation_id = ctx.activity.conversation.id
+
+    # Gets all members of the conversation.
+    members = await ctx.api.conversations.members(conversation_id).get_all()
 ```
 
 # [JSON](#tab/json)
@@ -150,15 +125,14 @@ The following sample code is used to get single member details:
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/bot-sequential-flow-adaptive-cards/csharp/SequentialUserSpecificFlow/Bots/UserSpecificBot.cs#L37)
 
 ```csharp
-public class MyBot : TeamsActivityHandler
+app.OnMessage(async context =>
 {
-    protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
-    {   
-        // Gets the account of a single conversation member.
-        // This works in one-on-one, group, and team scoped conversations.
-        var member = await TeamsInfo.GetMemberAsync(turnContext, turnContext.Activity.From.Id, cancellationToken);
-    }
-}
+    var conversationId = context.Activity.Conversation.Id;
+    var memberId = context.Activity.From.Id;
+
+    // Gets a single member by ID.
+    var member = await context.Api.Conversations.Members.GetByIdAsync(conversationId, memberId);
+});
 ```
 
 # [TypeScript](#tab/typescript)
@@ -168,19 +142,13 @@ public class MyBot : TeamsActivityHandler
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/bot-conversation/nodejs/bots/teamsConversationBot.js#L186)
 
 ```typescript
-export class MyBot extends TeamsActivityHandler {
-    constructor() {
-        super();
+app.on('message', async ({ activity, api }) => {
+    const conversationId = activity.conversation.id;
+    const memberId = activity.from.id;
 
-        // See learn.microsoft.com/en-us/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0 to learn more about the message and other activity types.
-        this.onMessage(async (turnContext, next) => {
-            const member = await TeamsInfo.getMember(turnContext, encodeURI('[email protected]'));
-
-            // By calling next() you ensure that the next BotHandler is run.
-            await next();
-        });
-    }
-}
+    // Gets a single member by ID.
+    const member = await api.conversations.members(conversationId).getById(memberId);
+});
 ```
 
 # [Python](#tab/python)
@@ -190,11 +158,13 @@ export class MyBot extends TeamsActivityHandler {
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/bot-conversation/python/bots/teams_conversation_bot.py#L67)
 
 ```python
-async def _show_members(
-    self, turn_context: TurnContext
-):
-    # TeamsInfo.get_member: Gets the member of a team scoped conversation.
-    member = await TeamsInfo.get_member(turn_context, turn_context.activity.from_property.id)
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    conversation_id = ctx.activity.conversation.id
+    member_id = ctx.activity.from_.id
+
+    # Gets a single member by ID.
+    member = await ctx.api.conversations.members(conversation_id).get(member_id)
 ```
 
 # [JSON](#tab/json)
@@ -250,22 +220,21 @@ The following sample code is used to get team's details:
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/TeamsJS/msteams-application-qbot/Source/Microsoft.Teams.Apps.QBot.Web/Bot/QBotTeamInfo.cs#L44)
 
 ```csharp
-public class MyBot : TeamsActivityHandler
+app.OnMessage(async context =>
 {
-    protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
+    var teamId = context.Activity.ChannelData?.Team?.Id;
+
+    if (teamId != null)
     {
-        // Gets the details for the given team id. This only works in team scoped conversations.
-        // TeamsGetTeamInfo: Gets the TeamsInfo object from the current activity.
-        TeamDetails teamDetails = await TeamsInfo.GetTeamDetailsAsync(turnContext, turnContext.Activity.TeamsGetTeamInfo().Id, cancellationToken);
-        if (teamDetails != null) {
-            await turnContext.SendActivityAsync($"The groupId is: {teamDetails.AadGroupId}");
-        }
-        else {
-            // Sends a message activity to the sender of the incoming activity.
-            await turnContext.SendActivityAsync($"Message did not come from a channel in a team.");
-        }
+        // Gets team details by ID.
+        var teamDetails = await context.Api.Teams.GetByIdAsync(teamId);
+        await context.Send($"The groupId is: {teamDetails.AadGroupId}");
     }
-}
+    else
+    {
+        await context.Send("Message did not come from a channel in a team.");
+    }
+});
 ```
 
 # [TypeScript](#tab/typescript)
@@ -275,45 +244,34 @@ public class MyBot : TeamsActivityHandler
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/app-complete-sample/nodejs/server/dialogs/teams/fetchTeamInfoDialog.js#L21)
 
 ```typescript
-export class MyBot extends TeamsActivityHandler {
-    constructor() {
-        super();
-
-        // See https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0 to learn more about the message and other activity types.
-        this.onMessage(async (turnContext, next) => {
-
-            // Gets the details for the given team id.
-            const teamDetails = await TeamsInfo.getTeamDetails(turnContext);
-            if (teamDetails) {
-
-                // Sends a message activity to the sender of the incoming activity.
-                await turnContext.sendActivity(`The group ID is: ${teamDetails.aadGroupId}`);
-            } else {
-                await turnContext.sendActivity('This message did not come from a channel in a team.');
-            }
-
-            // By calling next() you ensure that the next BotHandler is run.
-            await next();
-        });
+app.on('message', async ({ activity, api, send }) => {
+    const teamId = activity.channelData?.team?.id;
+
+    if (teamId) {
+        // Gets team details by ID.
+        const teamDetails = await api.teams.getById(teamId);
+        await send(`The group ID is: ${teamDetails.aadGroupId}`);
+    } else {
+        await send('This message did not come from a channel in a team.');
     }
-}
+});
 ```
 
 # [Python](#tab/python)
 
 [SDK reference](/python/api/botbuilder-core/botbuilder.core.teams.teamsinfo?view=botbuilder-py-latest&preserve-view=true#botbuilder-core-teams-teamsinfo-get-team-details)
 
 ```python
-async def _show_details(self, turn_context: TurnContext):
-
-    # Gets the details for the given team id.
-    team_details = await TeamsInfo.get_team_details(turn_context)
-
-    # MessageFactory.text(): Specifies the type of text data in a message attachment.
-    reply = MessageFactory.text(f"The team name is {team_details.name}. The team ID is {team_details.id}. The AADGroupID is {team_details.aad_group_id}.")
-
-    # Sends a message activity to the sender of the incoming activity.
-    await turn_context.send_activity(reply)
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    team_id = ctx.activity.channel_data.get("team", {}).get("id") if ctx.activity.channel_data else None
+
+    if team_id:
+        # Gets team details by ID.
+        team_details = await ctx.api.teams.get_by_id(team_id)
+        await ctx.send(f"The team name is {team_details.name}. The AADGroupID is {team_details.aad_group_id}.")
+    else:
+        await ctx.send("Message did not come from a channel in a team.")
 ```
 
 # [JSON](#tab/json)
@@ -353,57 +311,48 @@ The following sample code is used to get the list of channels in a team:
 * [Sample code reference](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/TeamsJS/msteams-application-qbot/Source/Microsoft.Teams.Apps.QBot.Web/Bot/QBotTeamInfo.cs#L57)
 
 ```csharp
-public class MyBot : TeamsActivityHandler
+app.OnMessage(async context =>
 {
-    // Override this in a derived class to provide logic specific to Message activities.
-    protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
-    {
-        // Returns a list of channels in a Team. This only works in team scoped conversations.
-        IEnumerable<ChannelInfo> channels = await TeamsInfo.GetTeamChannelsAsync(turnContext, turnContext.Activity.TeamsGetTeamInfo().Id, cancellationToken);
+    var teamId = context.Activity.ChannelData?.Team?.Id;
 
-        // Sends a message activity to the sender of the incoming activity.
-        await turnContext.SendActivityAsync($"The channel count is: {channels.Count()}");
+    if (teamId != null)
+    {
+        // Gets channels (conversations) for the team.
+        var channels = await context.Api.Teams.GetConversationsAsync(teamId);
+        await context.Send($"The channel count is: {channels.Count}");
     }
-}
+});
 ```
 
 # [TypeScript](#tab/typescript)
 
 [SDK reference](/javascript/api/botbuilder/teamsinfo?view=botbuilder-ts-latest&preserve-view=true#botbuilder-teamsinfo-getteamchannels)
 
 ```typescript
-export class MyBot extends TeamsActivityHandler {
-    constructor() {
-        super();
-
-        // See https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0 to learn more about the message and other activity types.
-        this.onMessage(async (turnContext, next) => {
+app.on('message', async ({ activity, api, send }) => {
+    const teamId = activity.channelData?.team?.id;
 
-            // Supports retrieving channels hosted by a team.
-            const channels = await TeamsInfo.getTeamChannels(turnContext);
-
-            // Sends a message activity to the sender of the incoming activity.
-            await turnContext.sendActivity(`The channel count is: ${channels.length}`);
-
-            // By calling next() you ensure that the next BotHandler is run.
-            await next();
-        });
+    if (teamId) {
+        // Gets channels (conversations) for the team.
+        const channels = await api.teams.getConversations(teamId);
+        await send(`The channel count is: ${channels.length}`);
     }
-}
+});
 ```
 
 # [Python](#tab/python)
 
 [SDK reference](/python/api/botbuilder-core/botbuilder.core.teams.teamsinfo?view=botbuilder-py-latest&preserve-view=true#botbuilder-core-teams-teamsinfo-get-team-channels)
 
 ```python
-async def _show_channels(
-    self, turn_context: TurnContext
-):
-    # Supports retrieving channels hosted by a team.
-    channels = await TeamsInfo.get_team_channels(turn_context)
-    reply = MessageFactory.text(f"Total of {len(channels)} channels are currently in team")
-    await turn_context.send_activity(reply)
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    team_id = ctx.activity.channel_data.get("team", {}).get("id") if ctx.activity.channel_data else None
+
+    if team_id:
+        # Gets channels (conversations) for the team.
+        channels = await ctx.api.teams.get_conversations(team_id)
+        await ctx.send(f"Total of {len(channels)} channels are currently in team")
 ```
 
 # [JSON](#tab/json)