Get the most out of passive channel listening
Overview
Section titled “Overview”Passive listening has Promptless read the Slack and Microsoft Teams channels you choose and draft documentation updates from the conversations there, without anyone mentioning it. Use it on channels where questions and product decisions come up that your docs should reflect, such as a support channel shared with a customer. Promptless evaluates messages as they’re posted and drafts a suggestion only when a conversation warrants one.
This page covers choosing channels, adding the triggers, and what to expect once listening is on. It also covers how to have Promptless act on a specific message.
Before you start
Section titled “Before you start”- At least one active doc collection. Without one, passive listening has nowhere to send suggestions and does nothing.
- An admin role in your Promptless organization, to edit the Configuration page.
- For Slack, the Promptless Slack app in your workspace. For a private channel or a Slack Connect channel, Promptless must also be a member of the channel. The setup steps cover adding it.
- For Microsoft Teams, the Promptless Teams app installed with permission to read channel messages, and admin consent. Teams support is in beta. Email help@gopromptless.ai to turn it on for your organization, then see Connect Microsoft Teams.
Pick the right channels
Section titled “Pick the right channels”Point passive listening at low-volume, high-signal channels. Good candidates include a Slack Connect channel shared with a customer, a dedicated #docs-feedback channel, or an internal channel where the team makes product decisions. Avoid a busy channel like #general, where Promptless evaluates many messages and few are worth documenting.
For example, a team points passive listening at the Slack Connect channel they share with a customer. Over a week, three people ask some version of “how do I rotate our API key?” Promptless notices the docs don’t answer the recurring question and drafts a new FAQ entry. The team reviews and publishes it, and the next customer who asks finds the answer in the docs. Community and internal channels where the same question keeps coming up work the same way.
Set up listening
Section titled “Set up listening”-
Optional. For a private or Slack Connect channel, add Promptless to the channel in Slack. See Add Promptless to a channel. Promptless joins a public channel on its own when you add the channel to a trigger.
-
On the Configuration page, open the Triggers tab.
-
Select Add an automatic or scheduled trigger, then select A Slack channel or A Microsoft Teams channel.
-
Under Which channels should Promptless watch? or Which Teams channels should Promptless watch?, choose the channels to monitor:
-
For Slack, choose channels from the list, or enter channel names without the
#prefix. -
For Teams, choose channels from the list, or paste a channel’s conversation ID, which looks like
19:...@thread.tacv2.
-
-
Select Add trigger.
Promptless tracks Slack channel renames, so renaming a monitored channel doesn’t break the trigger. To stop monitoring a channel, edit or remove its trigger on the Triggers tab.
The Configuration page stores each trigger in promptless.yaml. To manage triggers as configuration, edit the YAML directly. This example has one slack_listen trigger and one msteams_listen trigger:
triggers: support-channels: trigger_type: slack_listen match: - channels: - slack-connect-acme - docs-feedback teams-support: trigger_type: msteams_listen match: - channel_ids: - 19:abc123@thread.tacv2For every match field, see the Configuration Reference.
Know what to expect from passive listening
Section titled “Know what to expect from passive listening”Promptless drafts a suggestion when a conversation shows a gap or error in your docs, or new information worth documenting. The result can be a correction to an existing page as well as a new one. Most conversations produce no change, and that’s expected: Promptless stays quiet on ordinary chatter.
Once listening is on:
- Promptless doesn’t acknowledge or answer a message it reads through passive listening. Its suggestions appear in your review queue and in the notification channel set in your policies. Questions for your team go to the escalation channel set there.
- Reading a thread doesn’t make Promptless follow it, in Slack or Teams. Promptless shows nothing in the thread and doesn’t answer replies there until someone @mentions it in the thread or it posts there. After that, it follows the thread like any other.
- Knowledge Base instructions, such as notification preferences or
PROMPTLESS.md, can also send notifications to a watched thread. For example, an instruction to send notifications to the thread where a request started makes Promptless post a suggestion notification as a reply there. Promptless then follows that thread. To keep watched threads silent, check that your Knowledge Base instructions don’t send notifications to the originating thread. - When a monitored thread keeps evolving, Promptless updates the suggestion it already opened for that thread, so you see one suggestion rather than several.
- Promptless processes the messages it reads to draft suggestions and doesn’t retain them. See Data handling.
Steer it in the moment
Section titled “Steer it in the moment”To have Promptless act on a specific message or thread right away, mention @Promptless in it. A mention runs immediately as a normal request, without the passive “is this worth documenting?” judgment.
Once Promptless is active in a thread, it keeps listening to replies, so you can refine a suggestion or add context without mentioning it again. To have it skip a reply, start the message with aside or /aside. An organization-level setting decides whether Promptless listens to all replies or only to mentions. To change it, see Change the thread reply trigger mode.
See also
Section titled “See also”- Slack messages, for every way to start Promptless from Slack
- Review from Slack and Teams, for other ways to work with Promptless in Teams
- Thread auto-reply, for how Promptless handles follow-up replies
- Get support, for help choosing channels or tuning passive listening