Capture common errors and provide resolution steps for Microsoft Teams using the Conversational Interfaces Diagnostic Tool

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Capture common errors and provide resolution steps for Microsoft Teams using the Conversational Interfaces Diagnostic Tool

    The Conversational Interfaces Diagnostic Tool is designed to generate health reports for the Microsoft Teams integration, capturing essential data on plugins, configuration settings, system properties, and integration failures. Users can validate their settings and troubleshoot issues identified in the health report.

    Show full answer Show less

    Key Features

    • Health Reporting: The tool categorizes common issues into groups such as response failures, notifications, automatic linking, performance, and installation problems.
    • Error Resolution: Users can log in to the chat widget, initiate the CI Diagnostic Tool, and select specific issue categories to generate a targeted report.
    • Knowledge Base Integration: The tool provides access to relevant Knowledge Base articles that offer solutions to identified issues.

    Key Outcomes

    Upon running the health check, users receive a detailed report that includes:

    • Verification of plugin installations and dependencies.
    • Identification of recent errors and HTTP transactions.
    • Options to explore Knowledge Base articles for further insights.
    • Resolution steps for specific problem types.

    Users can confirm whether their issues are resolved, ensuring a streamlined troubleshooting process and improved integration with Microsoft Teams.

    The Conversational Interfaces Diagnostic Tool runs a health report to define and capture information for different categories of the Conversational Integration with Microsoft Teams app, such as plugin details, configuration settings, system properties, integration failures, and so on, and lets the user validate and review these settings to start a bot-conversation.

    When a user runs the health check scan and if there are issues that are shown on the report, then the user can take actions to resolve the issues based on the recommendations that the bot provides through the CI Diagnostic Tool.

    Grouping common errors

    To provide a health report of the various aspects of the Conversational Integration with Microsoft Teams application, the most common issues have been grouped into the following categories:
    • Microsoft Teams not responding
    • Notifications
    • Automatic Linking
    • Image/HTML
    • Performance
    • Installation
    • Live Agent

    Resolution

    The Conversational Interfaces Diagnostic Tool is used to resolve the errors that users come across with their Microsoft Teams app. Knowledge Base articles are documented with resolutions to the issues and the records for these KB articles are created in the CI Diagnostic Tool.
    Note:
    Microsoft Teams requires the CI Diagnostics Tool of version 1.1.0 to make the diagnostic topic available for the user.
    Resolving errors using the CI Diagnostic Tool includes the following steps:
    1. Login into the chat widget and start the CI Diagnostic Tool.
      The CI Diagnostic Tool presents the following groups to choose from:
      • Error Message
      • System Property Lookup
      • Plugin/Functionality Issue
      • General Question
    2. Select Plugin/Functionality Issue and type Conversational Integration with Microsoft Teams or any related keyword to get the options of available plugins related to your search term.

      The Microsoft Teams application logo appears as a response.

    3. After Microsoft Teams is provided as an input to the CI Diagnostic tool, a basic health check of the app gets executed and a report is generated for the user.
      The health check is run to verify if:
      • Microsoft Teams app plugin installed
      • Provider application record verification.
      • Message auth table has all the records
      • Dependant plugins are available
      • OIDC token verification records are available
      • Provider reference is missing in the [sys_cs_provider_application] table

      After successful health check scan, verifications such as recent installation errors, recent syslog errors, and recent HTTP transactions are presented to the user.

    4. The health check report also provides you with an option to view existing Knowledge Base articles that may be associated with your issue. Enter Yes and provide a few words to describe your issue.

      For example, if you enter image as your issue description, then the CI Diagnostic tool presents you with the Knowledge Base articles related to images. Select the link to view the Knowledge Base article.

      Select No to proceed for additional support.

    5. The CI Diagnostic Tool provides you with an additional support topic available for the Microsoft Teams plugin. Select Yes to proceed.

      You are presented with the following issue types to select from.

      For example, if you select any one of the issue types, the CI Diagnostic Tool provides you with the resolution steps pertaining to that issue type to identify the cause of the issue and to resolve it. You will also be presented with the relevant Knowledge Base articles to get further details about the issue.

      Finally, the CI Diagnostic Tool asks you to check if your issue is resolved. Select Yes if the issue is resolved.