Self-help diagnostics available for Microsoft Teams Administrators
Published Apr 13 2020 12:22 PM 30.2K Views

Oct 14, 2020 Update: This content has been promoted to - from here on we will maintain the Self Help Diagnostics list over there, so be sure to check out the new doc!  Also don't miss the new feature we added to quickly and easily call up the Diagnostics in the Admin Portal - for example, type in "Diag: Teams Dial Pad Missing" and it takes you directly to the diagnostic:




As Microsoft Teams usage continues to grow we know that you have questions about how to perform common Administrative tasks, configure your Teams tenants to serve Remote Workers, and troubleshoot issues when they arise. 


Over the last several weeks, we’ve developed 16 17! Teams-specific diagnostic scenarios that cover top support issues and most common areas where Administrators like you ask us for configuration help.  It is important to note that while these diagnostics cannot make changes to your Tenant, they do provide insights into known issues and instructions for you to go fix it quickly. 


With that in mind, let’s take a look at the experience.  While logged in as an Admin, visit your Microsoft 365 admin center. In the left-hand navigation pane, select Show all > Support > New service request. After you briefly describe your issue (let’s use the example “I can't invite a guest to Teams”), we’ll use that information to determine if a diagnostic scenario matches your issue.  Pro-tip – if you type some search terms and see a type-ahead query pop up that matches the general area you’re looking for, please click it!  We’ll talk more about why in a future post. 


can't invite guest.png


After entering your organization’s root URL (in the Guest Access diagnostic you should be able to click the drop down arrow and select a pre-populated URL from your Tenant), click Run tests.


Once the diagnostic checks have completed for the scenario, if we find a problem, we’ll show you what we found, and provide steps to resolve the configuration issue. In this example, the Tenant Admin had not turned on Guest Access:


Guest Access is turned off!Guest Access is turned off!


Here a list of diagnostics with brief scenario descriptions we already have today:

  • Teams Sign-in - Have a user or users that can't sign-in to Teams app?  Run this diagnostic.
  • Teams Direct Routing - Have a user or users that cannot make a PSTN call using Direct Routing in Teams?  This diagnostic validates that user is correctly configured to use Direct Routing.
  • Teams Call Queue - Did you create a Call Queue but it isn't working?  This diagnostic validates that a Teams Call queue can answer calls. 
  • Teams Remove Number from Conference Bridge - Sometimes you cannot remove (disassociate) a telephone number from a Conference Bridge - this diagnostic will help you determine why.  
  • Teams Dial Pad is missing - User or users not seeing a dial pad in Teams?  This is your diag!  
  • Teams Calendar App - Sometimes users won't see the Calendar app in Teams.  This diagnostic will help you determine why.
  • Teams Federation - For TeamsOnly users - can't federated chat with a TeamsOnly user in another company?  This diagnostic will help you figure out why.  
  • Teams Files Guest Access Have you successfully invited a Guest to your Teams, but they cannot access shared files?  This is your diag!  
  • Teams Add-in is missing in Outlook This diagnostic determines if the Teams user is eligible for the Teams Meeting add-in for Outlook - if they are, but the Add-in is still missing, be sure to follow up with the client side diagnostic available here.  
  • Unable to invite Guest users to Teams - Tried to configure Guest Access but it's not working?  Users still can't invite Guests to Teams?  Run this diagnostic (screenshots above).
  • Unable to make domestic PSTN calls in Teams - If a user can't make local PSTN calls (in-country, i.e. 'domestic') - run this diagnostic that checks User licensing and configuration.  
  • Unable to make International PSTN calls in Teams - If a user can't make international PSTN calls (to another country) - run this diagnostic that checks User licensing and configuration.  
  • Unable to create a Teams conference call - Specifically a Dial-in Conference also known as a PSTN Conference - usually the dial-in coordinates are not included when a meeting is created in Outlook.  Run this diagnostic to understand why.  
  • Unable to join a Teams conference call - Got a user or users complaining they can't dial into a Teams Audio Conference (meeting)?  Not for native client Joins - dial in - this is the diag.  
  • Teams Auto-Attendant Tried to setup a Teams Auto Attendant and it's not working?  Run this diagnostic to check the configuration and settings.  
  • *New* We Can't Get Your Files - If you have Users in your organization seeing a "we can't get your files" error attempting to access a shared file in Teams, run this diagnostic.  It will come up if you type in the exact error message.  
  • *New* Unable to Schedule a Teams Meeting on behalf of Delegate in Outlook - Having trouble scheduling a Teams Meeting on behalf of someone else in Outlook?  This diagnostic checks the back end permissions to ensure the Delegates (Boss/Admin) relationship is configured correctly.

We plan to highlight individual diagnostics in separate blog posts in future posts and we’re developing more diagnostic scenarios all the time, so be sure to Favorite and Follow.


As always, we value your feedback. Send us a note and tell us what other types of diagnostic scenarios you’d like to see for Teams.



Version history
Last update:
‎Oct 14 2020 02:20 PM
Updated by: