Share via

Teams Desktop/Web shows "Unable to reach app" for Adaptive Card action — works on Mobile

Nariman NAHMADOV 0 Reputation points
2026-05-01T10:49:54.9866667+00:00

We are seeing inconsistent behavior in a Microsoft Teams bot when handling Adaptive Card button clicks.

When a user clicks a button (👍 / 👎):

  • On Teams Mobile: works correctly, no error
  • On Teams Desktop/Web: UI updates correctly, but an error appears: "Unable to reach app. Please try again."

Details:

  • The bot returns HTTP 200
  • The card is updated successfully
  • No errors occur on the server side

So the action is processed correctly, but Desktop/Web still shows an error.

Question: Is there a known difference in how Teams Desktop/Web and Mobile handle Adaptive Card actions?

Are there any specific requirements for responses that Desktop/Web enforces more strictly?

Thank you.We are seeing inconsistent behavior in a Microsoft Teams bot when handling Adaptive Card button clicks.

When a user clicks a button (👍 / 👎):

  • On Teams Mobile: works correctly, no error
  • On Teams Desktop/Web: UI updates correctly, but an error appears:
    "Unable to reach app. Please try again."

Details:

  • The bot returns HTTP 200
  • The card is updated successfully
  • No errors occur on the server side

So the action is processed correctly, but Desktop/Web still shows an error.

Question:
Is there a known difference in how Teams Desktop/Web and Mobile handle Adaptive Card actions?

Are there any specific requirements for responses that Desktop/Web enforces more strictly?

Thank you.

Microsoft Teams | Development
Microsoft Teams | Development

Building, integrating, or customizing apps and workflows within Microsoft Teams using developer tools and APIs

0 comments No comments

1 answer

Sort by: Most helpful
  1. Michelle-N 15,545 Reputation points Microsoft External Staff Moderator
    2026-05-01T14:11:43.29+00:00

    Hi @Nariman NAHMADOV

    Based on the details you provided, I understand that your Teams bot is successfully processing Adaptive Card actions (HTTP 200), but the Desktop and Web clients are displaying the "Unable to reach app" error despite the card updating correctly.

    Recent updates to the Teams Desktop and Web clients have made response handling much stricter compared to the Mobile client. While Mobile may only look for a successful HTTP 200 status, Desktop/Web also validates the structure and timing of the response payload. If the format isn't exactly what the client expects or if the response takes too long, the UI will trigger a timeout error even if the action was technically processed.

    Teams Desktop/Web requires a specific JSON structure for invoke activities. Ensure your bot is returning the updated card in the response body immediately. A standard successful response should look like this:

    {
      "statusCode": 200,
      "type": "application/vnd.microsoft.card.adaptive",
      "value": { 
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [ /* Your updated card JSON here */ ]
      }
    }
    
    

    If you are currently using Action.Submit, I recommend migrating to Universal Actions (Action.Execute). Universal Actions were designed to provide a consistent experience across all platforms. They handle loading states much better and are the preferred method for modern Teams bot development.

    You can find the implementation details here: Universal Actions for Adaptive Cards.

    Teams expects an invoke response within 5 seconds. If your bot performs heavy processing before returning the updated card, the Desktop client might "give up" and show the error. Ensure you are sending the response as quickly as possible.

    I hope this helps resolve the inconsistency! Please let me know if you need more details.


    If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".     

    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.


Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.