Skip to main content
All CollectionsEnterpriseTechnical SetupIntegrations
Update Your Microsoft Teams Integration Bot App Password
Update Your Microsoft Teams Integration Bot App Password

How to update your MS TEAMS bot password to keep the integration working.

Joel Bradley avatar
Written by Joel Bradley
Updated over a week ago
PDF VERSION

Tags | Integrations | MS Teams |

Applies to: Enterprise

ADMIN PRIVILEGES REQUIRED

This documentation is for Stack Overflow for Teams Enterprise. Free, Basic, and Business users can access their documentation here. Find your plan.

Overview

If you’re using the Stack Overflow for Teams Enterprise (SOE) Microsoft Teams integration, you’ll eventually need to update the MS Teams bot app password for the integration to continue working. Setting the bot password is part of the initial MS Teams integration installation.

NOTE: There's no direct way to tell when your bot password will expire at https://dev.teams.microsoft.com. Your IT admins set password policy at the Microsoft enterprise level, so you may want to reach out to them for details on your company's password policy.

Confirm an expired bot password

If you've made no changes to your MS Teams integration and it stops working, your app bot password has likely expired. Here's what to look for:

  1. You've stopped receiving webhook notifications and/or replies from the chatbot within your MS Teams integration.

  2. You see System.NullReferenceException: Object reference not set to an instance of an object exceptions on the /admin/errors page. These exceptions may be thrown from /integrations/microsoft-teams/messages or another MS Teams integration-related route.

  3. You see an alert stating that the integration is broken when navigating to your site's Microsoft Teams setup page at Admin settings -> Microsoft Teams.

The following process will help you get your MS Teams integration working again.

Generate a new secret on MS Teams

  1. Navigate to https://dev.teams.microsoft.com/bots to access the Bot Management tool in your Microsoft Teams Developer Portal. ​

  2. Locate and click on your bot.

  3. Click Client Secrets to generate a new Client Secret.

  4. Click + Add a secret.

  1. Copy the new secret to your clipboard.

NOTE: Microsoft's Copy to clipboard button (clipboard and paper icon) can be unreliable. We recommend manually selecting and copying the secret.

Update the password on SOE

  1. Go to your SOE site's Microsoft Teams setup page by clicking Admin settings in the left-hand menu, then Microsoft Teams.

  2. Follow the instructions in the "Update your bot credentials" section.

  1. Paste the new secret you copied earlier into the designated field and click Update password.

Did this answer your question?