Microsoft Teams messages (beta)

Tip

You can set up this trigger by hand as this page describes, or ask Promptless in Slack or Microsoft Teams to do it for you. For example, “@Promptless turn on passive listening for my Teams support channel.” See Ask Promptless to update your configuration.

Note

The Microsoft Teams trigger feature is in beta. Contact help@gopromptless.ai for more information about enabling this feature for your organization.

Microsoft Teams integration enables documentation updates directly from your team conversations. This is particularly useful for support conversations or internal discussions where questions arise that could be better addressed in your documentation.

Trigger methods

Use a message action

Right-click any Teams message (or use the message menu) and select Update docs with Promptless to trigger documentation analysis. You can optionally add instructions to guide the update—for example, “Focus on the error handling steps” or “Update the API reference section.”

Teams displays a confirmation after you submit, and the suggestion typically appears within a few minutes.

Mention @Promptless in a Channel

Tag @Promptless in a Teams channel with specific instructions or questions. Promptless analyzes the full thread context to create relevant documentation updates.

Send a direct message

Send documentation requests directly to @Promptless in a personal chat. This is useful for private documentation requests with comprehensive context support.

How it works

When triggered in Microsoft Teams:

1. Message Analysis: Promptless reads the message and conversation context where it was triggered
2. Context Gathering: The system analyzes text content and conversation flow
3. Documentation Suggestions: Promptless creates suggestions based on the conversation content
4. Follow-up Editing: Continue editing suggestions within the same thread using @Promptless mentions

Thread reply auto-listening

Promptless automatically monitors threads where it’s participating. When someone replies to a thread where Promptless has posted or been @mentioned, Promptless treats the reply as a follow-on trigger—no additional @mention required.

This means you can:

• Reply to a notification thread with feedback or additional context
• Continue a conversation Promptless started without tagging it again
• Provide additional details or clarifications that Promptless requested

Opting Out of Individual Messages

Promptless tries to reason about whether each message in a thread is actionable—not every reply will trigger a documentation update. However, if you want to explicitly tell Promptless to ignore a message, start it with aside or /aside:

aside This is an internal discussion point, not for docs.

Thread reply trigger mode

Open Settings and select Organization to configure how Promptless handles thread replies:

• Listen to all replies (default): Process all replies in threads where Promptless is participating. Use the aside prefix to skip specific messages.
• Require @promptless: Only process replies that explicitly @mention Promptless.

This setting applies organization-wide to both Slack and Teams threads.

Passive channel listening (optional)

You can optionally enable passive listening for specific Teams channels. When enabled, Promptless automatically monitors conversations in your selected channels and creates documentation suggestions when threads become inactive.

Before You Begin

Make sure the Promptless app is installed in the team containing the channels you want to monitor.

To enable passive listening:

1. Edit your Microsoft Teams trigger project
2. Check the box for “Listen for all messages in specific channels”
3. Select which Teams channels to monitor
4. Save your configuration

Caution

Passive listening is completely opt-in and only applies to channels you explicitly select. Promptless cannot access channels in teams where it hasn’t been installed.

Customizing Behavior

If you want Promptless to follow specific instructions when processing messages in a monitored channel, add those instructions to your Agent KB in the PROMPTLESS.md file. By default, Promptless uses its best judgment to decide what should be documented, but custom instructions can help tailor the output for your needs.

Configuration

@Promptless mentions in Microsoft Teams are a built-in trigger type that’s always active when the Teams integration is connected, no YAML configuration required.

To enable passive channel listening, add an msteams_listen trigger to your Configuration page:

triggers:
  teams-support:
    trigger_type: msteams_listen
    match:
      - channel_ids:
          - 19:abc123@thread.tacv2

Publishing behavior and notifications are controlled by your policies configuration.

Teams notifications

When Promptless creates documentation suggestions from Teams triggers, it replies directly in the thread with a rich Adaptive Card showing:

• Suggestion title and description
• Status details including creation date, branch name, and affected files
• Interactive action buttons

Interactive action buttons

Teams suggestion cards include buttons that let you take action directly from Teams:

• Publish — Merges the docs PR and publishes the changes. The card updates in-place to show the result.
• Create PR — Opens a documentation pull request. The card refreshes to show the new PR link.
• View PR — Opens the docs PR in your browser.
• Review in Promptless — Opens the suggestion in the Promptless dashboard.

Publish and Create PR execute server-side and update the card with the result, so you can manage documentation directly from Teams without switching contexts.

Privacy and channel access

By default, Promptless only reads Teams content when you explicitly trigger it by @mentioning @Promptless or using a message action. If you enable passive listening, Promptless monitors only the specific channels you select in your project configuration.

Setup instructions

To connect Microsoft Teams to Promptless, see the Microsoft Teams Integration setup guide.

Note

Microsoft Teams integration requires admin center access to install the Promptless Teams app. See the setup guide for detailed installation instructions.