Merge pull request #2370 from OfficeDev/v-hrajandira/UpdatingTeamsSDKReadme

AjayJ12-MSFT · web-flow · commit 42ca0d6e8c03 · 2026-07-01T12:00:08.000+05:30
docs: Add Teams SDK troubleshooting guide with language-specific issu…
diff --git a/samples/TeamsSDK/bot-ai-messages/README.md b/samples/TeamsSDK/bot-ai-messages/README.md
@@ -85,7 +85,16 @@ Once provisioning completes, start your bot - the sample will pick up the creden
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive these CLI steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
diff --git a/samples/TeamsSDK/bot-attachments/README.md b/samples/TeamsSDK/bot-attachments/README.md
@@ -85,7 +85,16 @@ Once provisioning completes, start your bot - the sample will pick up the creden
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive these CLI steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
diff --git a/samples/TeamsSDK/bot-auth-quickstart/README.md b/samples/TeamsSDK/bot-auth-quickstart/README.md
@@ -396,15 +396,23 @@ For Python:
 ```bash
 python main.py
 ```
+# Teams SDK Troubleshooting
 
-## Troubleshooting
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
 
-- If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable
-- Ensure your configuration file (`.env`, `appsettings.json`) is set up correctly
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
+
+- If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
+- Ensure your `.env` or `appsettings.json` file is set up correctly.
+- Use the Channels UI in Azure Bot Service in the Azure Portal to see detailed endpoint errors.
 - Verify that `"token.botframework.com"` is included in `validDomains` in your manifest.json
 - For OAuth issues, confirm your Azure AD app registration has the correct redirect URIs
 - Check that admin consent has been granted for the required Graph API permissions
-- Use the Channels UI in Azure Bot Service in the Azure Portal to see detailed endpoint errors
 
 ### Enabling Verbose Logs
 
diff --git a/samples/TeamsSDK/bot-cards/README.md b/samples/TeamsSDK/bot-cards/README.md
@@ -84,7 +84,16 @@ Once provisioning completes, start your bot - the sample will pick up the creden
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive these CLI steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
diff --git a/samples/TeamsSDK/bot-meetings/README.md b/samples/TeamsSDK/bot-meetings/README.md
@@ -226,10 +226,20 @@ Once the bot is running and added to Teams, you can interact with it in meetings
 - Request and view meeting transcripts
 - Use adaptive cards to interact with meeting data
 
-## Troubleshooting
+# Teams SDK Troubleshooting
 
-- If Teams cannot communicate with your bot, verify your tunnel URL is reachable
-- Ensure your `.env` or `appsettings.json` file is set up correctly
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
+
+- If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
+- Ensure your `.env` or `appsettings.json` file is set up correctly.
+- Use the Channels UI in Azure Bot Service in the Azure Portal to see detailed endpoint errors.
 - Verify that admin consent has been granted for the required Graph API permissions
 - Check that the application access policy has been configured correctly for your user
 - Confirm that Meeting event subscriptions are enabled in the bot registration (in the [Teams Developer Portal](https://dev.teams.microsoft.com), under **Tools** -> **Bot management** -> your bot)
diff --git a/samples/TeamsSDK/bot-message-extensions/README.md b/samples/TeamsSDK/bot-message-extensions/README.md
@@ -123,7 +123,16 @@ Once provisioning and manifest configuration are complete, start your bot and si
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive the CLI provisioning and manifest steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
diff --git a/samples/TeamsSDK/bot-quickstart/README.md b/samples/TeamsSDK/bot-quickstart/README.md
@@ -85,7 +85,16 @@ Once provisioning completes, start your bot - the sample will pick up the creden
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive these CLI steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
diff --git a/samples/TeamsSDK/bot-task-modules/README.md b/samples/TeamsSDK/bot-task-modules/README.md
@@ -108,7 +108,16 @@ Once provisioning completes, start your bot - the sample will pick up the creden
 
 > **Tip**: Using an AI coding assistant (GitHub Copilot CLI, Claude Code, Cursor, VS Code)? Install the [`teams-dev` agent skill](https://microsoft.github.io/teams-sdk/developer-tools/agent-skills) to drive these CLI steps from natural language - your assistant runs the right commands, manages credentials, and guides you through bot registration end-to-end.
 
-## Troubleshooting
+# Teams SDK Troubleshooting
+
+If you encounter errors you believe exists in Teams SDK, you can file an issue in GitHub for the langauge in which you encountered the issue
+- [C#](https://github.com/microsoft/teams.net/issues/new/choose)
+- [TypeScript](https://github.com/microsoft/teams.ts/issues/new/choose)
+- [Python](https://github.com/microsoft/teams.py/issues/new/choose)
+
+You can file general issues that exists across all SDK langauges [here](https://github.com/microsoft/teams-sdk/issues/new/choose)
+
+## General Troubleshooting
 
 - If Teams cannot communicate with your bot, verify your DevTunnels URL is reachable.
 - Ensure your `.env` or `appsettings.json` file is set up correctly.
