Skip to content

For the complete documentation index, see llms.txt.

Microsoft Teams integration (beta)

Install the Promptless app in your Microsoft Teams tenant so your team can start documentation work from Teams conversations. With Teams connected, you can:

By default, Promptless reads Teams content only when someone mentions it or uses the message action. With passive listening on, it also reads the channels you select, and only those. Promptless doesn’t archive or store your Teams messages. It uses large language models (LLMs), which can generate inaccurate results.

In this guide, you install the Teams app, link your tenant to Promptless, and choose which SharePoint sites Promptless can read shared files from.

  • An admin role in your Promptless organization.
  • Access to the Microsoft Teams admin center, with permission to manage app setup policies and install third-party apps.
  • A Microsoft admin to approve the admin-consent sign-in that links your tenant.
  • To let Promptless read files shared in channels, a SharePoint Administrator or Global Administrator with PowerShell.

Promptless requests these permissions through Teams resource-specific consent (RSC). A team owner consents to them when the app is installed in a team:

PermissionWhat Promptless uses it for
ChannelMessage.Read.GroupReads channel messages without an @mention, for passive listening.
TeamMember.Read.GroupResolves the identities of team members.
ChannelSettings.Read.GroupLists the team’s channels and their membership types, such as standard or private.

The app also has standard bot permissions, which let it send messages and notifications and read user information for mentions.

To install Promptless in Microsoft Teams, you need:

  • Microsoft Teams admin center access
  • Permissions to manage app setup policies in your organization
  • Ability to install and configure third-party apps

Connecting Teams has two stages. First, install the Promptless app into your Teams tenant (steps 1–3). Then link that tenant to your Promptless organization (step 4). The two stages are independent, and you can link before you install. Installing first, as numbered below, is the simplest path.

  1. Download the Promptless Teams app package from the Promptless integrations page.

    Download Teams app package from Promptless integrations page
  2. Upload the Promptless Teams app:

    1. Go to the Microsoft Teams admin center.
    2. In the left navigation, under Teams apps, select Manage apps. Manage apps controls which apps users in your organization can install.
    3. Select Actions > Upload new app.
    4. Choose the Promptless Teams app package you downloaded.
    5. Select Upload.
    Manage Apps Teams Manage Apps Overview Teams Upload Custom App Dialog
  3. Grant users access to the app:

    1. In the left navigation, select Setup policies.

      Teams Global Policy Configuration
    2. Select the Global (Org-wide default) policy.

    3. Turn on Upload custom apps and User pinning if they’re off. Users need these settings to install and pin custom apps like Promptless.

    4. Under Installed apps, select Add apps.

      Global Policy
    5. Search for “Promptless”, and add it to the policy.

    6. Select Save.

  4. Link your Teams tenant to Promptless. This stage happens in Promptless, outside the Microsoft Teams admin center:

    1. On the Promptless integrations page, find the Microsoft Teams integration.
    2. Select Link App & Grant Read Channels. This starts a Microsoft admin-consent sign-in that only a Microsoft admin can approve. If you’re not an admin, ask your Microsoft admin to complete this step.
    3. Approve the sign-in. This links your tenant to your Promptless organization.

Until your tenant is linked, the Promptless bot can’t map incoming Teams messages back to your organization. It replies that no workspace is connected.

If the button reads Contact Promptless, OAuth isn’t configured for your organization yet. Email help@gopromptless.ai to finish connecting.

To let Promptless read files attached in Teams channels, a Microsoft tenant administrator also chooses which SharePoint sites it can read from. See Choose which shared files Promptless can read.

When someone adds Promptless to their personal chat, Promptless sends a welcome message. It explains how to ask an admin to connect the tenant, how to mention @Promptless, and how to use the Update docs with Promptless message action. If someone uses Promptless before your tenant is linked, Promptless points them to the Integrations page, where an admin can finish the connection.

Promptless receives messages only from channels in teams where the app is installed. To use Promptless in a channel:

  1. Install the Promptless Teams app in the team that contains the channel.

  2. Optional. To have Promptless read the channel without an @mention, add the channel to your passive listening configuration.

Choose which shared files Promptless can read

Section titled “Choose which shared files Promptless can read”

Promptless reads files from Teams as context for the documentation it drafts. What it can read depends on where the file was shared:

Where the file was sharedWhat Promptless reads
A personal (1:1) chatAttached files and images, and inline images you paste into a message.
A channelInline images, and attached files stored on a SharePoint site that a Microsoft admin granted access to.
A group chatNothing that’s attached or pasted, including inline images.

A file on a SharePoint site without a grant shows as unavailable instead of being read. Access is granted per SharePoint site, not per channel. A team’s standard channels share one site, and each private or shared channel has its own site.

To grant access to a site, a SharePoint Administrator or Global Administrator completes these steps after the Teams connection is approved:

  1. On the Integrations page, on the Microsoft Teams card, select Choose SharePoint sites. After the first grant, the button reads Manage SharePoint site access.

  2. Select each site whose files Promptless should read.

  3. Copy the permission command the dialog generates, and run it in PowerShell.

  4. Select Verify access.

The card lists each granted site. A private or shared channel’s site appears only to its members. To grant one, reconnect Microsoft Teams as an admin who belongs to that channel. If your organization linked Teams before Promptless could read channel files, an admin reconnects and picks sites before channel files become available.