Installing Plain in your Teams channels
To setup Plain in your own Teams channels, you'll need to do the following.
1. Connect your Plain workspace to Teams
In Plain, navigate to Settings → Microsoft Teams.
Press
Connect to Teams.You will be redirected to Microsoft to complete an OAuth admin consent flow. Sign in with a Microsoft 365 administrator account and grant the requested permissions.
Once authorization is complete, you can download the Plain app manifest (.zip) for Teams.
2. Add the Plain app to Teams
The method of installation will depend on how Teams is configured for your organisation.
Option 1 - Install via Teams App
Navigate to the Apps tab, click Manage your apps, click Upload an app, and upload the .zip file.
Option 2 - Install via the Teams Admin Dashboard
In the left sidebar, navigate to Teams apps → Manage Apps, click Upload new app, and upload the .zip file.
If you don't see the option to upload a custom app, your Teams tenant may need additional configuration. See Enabling Custom App Uploads.
How threads are created from Teams
Plain creates threads differently depending on whether a message comes from a guest or a regular Teams member:
Guest messages: Any top-level message from a guest user immediately creates a new thread in Plain.
Regular member messages: Top-level posts from regular members do not create a thread on their own. A thread is created when someone replies to that post — at which point Plain backfills the entire conversation (the original post and all replies) into a new thread.
Authorize Teams users in Plain
By default, responses are sent from the Plain bot. To send replies under your own Teams identity instead, link your personal Microsoft account: navigate to Settings → Microsoft Teams and click Authorise replies. This is also required if you want to @mention other Teams users directly from Plain.