Forum Discussion

bertold's avatar
bertold
Copper Contributor
Jun 03, 2025
Solved

What is the recommended bot type for multi-tenant bots?

According to this https://learn.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-4.0&tabs=multitenant#bot-identity-information multi-tenant bots cannot...
BOT
microsoft teams
Multi-tenant
  • Ayush2001's avatar
    Ayush2001
    Jun 05, 2025

    The recommended and future-proof approach is to:

    ✅ Use a Teams App with an Azure AD Single-Tenant Bot and Publish it to AppSource

    Here’s why and how:

    1. Multi-tenant bot registration is deprecated: As per Microsoft's roadmap, starting July 31, 2025, you can no longer create bots with multi-tenant Azure AD apps.
    2. Incoming webhooks are also deprecated by end of 2025.
    3. AppSource distribution supports cross-tenant deployment:
      • Even if your bot is single-tenant, publishing your Teams app (with the bot) to the Microsoft Teams Store / AppSource allows external tenants to install and use it.
      • This is the supported method to reach tenants beyond your organization after multi-tenant support ends.

    Steps (short):

    • Create a single-tenant Azure AD bot in the Azure portal.
    • Package it in a Teams app manifest (manifest.json).
    • Ensure your bot supports tenant-specific behavior and handles tenantId in the activity payload.
    • Submit the app to Microsoft AppSource (requires validation & approval).
    • Tenants outside your org can install from the Teams App Store.

    This is the long-term, compliant path supported by Microsoft for cross-tenant bot usage.

    Thanks,
    Ayush

    If the response is helpful, please click "**Accept Answer**" and upvote it. You can share your feedback via [Microsoft Teams Developer Feedback](https://aka.ms/DevSupportFeedback) link. Click [here](https://aka.ms/DevCommunityEscalationForm) to escalate. 

renrutsirhc's avatar
renrutsirhc
Copper Contributor
Jun 05, 2025

We have the same question - having already built our bot integration. It seemed like quite a sudden change with pretty minimal communication!

bertold's avatar
bertold
Copper Contributor
Jun 05, 2025

I totally agree, renrutsirhc​ . I did not see this either in the https://learn.microsoft.com/en-us/microsoftteams/platform/whats-new?pivots=ga-feature section in the docs, or in the Teams blog. Maybe Pete_Daderko​ could help in the next What's new blog entry. It would be appreciated. There are so many outdated docs that refer to non-existent features. One such example is the documentation about https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-outgoing-webhook?tabs=urljsonpayload%2Cdotnet#create-outgoing-webhooks-1. Also, broken links - for example, the https://dev.teams.microsoft.com/appvalidation.html service page has a "quick survey link" that is just broken. I wanted to provide feedback, but I could not. There are also ton of "preview" / "beta" features - it is no surprise that it is hard to find what is supported and what is not. Another example here is the Azure CLI's support for Teams: full of preview (see screenshots).

 

Resources