Skip to content

Add caveats for passive channel listening #504

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hawkeyexl merged 4 commits into from
May 18, 2026
+8 −0
Merged

Add caveats for passive channel listening #504

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7fc356f
Add caveats for passive channel listening
promptless[bot] May 15, 2026
381f32a
Merge branch 'main' into promptless/passive-listen-caveats
promptless[bot] May 15, 2026
b6ae234
Merge branch 'main' into promptless/passive-listen-caveats
promptless[bot] May 15, 2026
5604f9e
Merge branch 'main' into promptless/passive-listen-caveats
promptless[bot] May 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions src/content/docs/docs/configuring-promptless/triggers/slack-messages.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,10 @@ This setting applies organization-wide to all Slack threads.

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

<Tip title="Before You Begin">
Make sure the Promptless bot is added to any channel you want to monitor. Promptless cannot view messages in channels where it hasn't been invited.
</Tip>
Copy link
Copy Markdown
Contributor Author

@promptless promptless Bot May 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added the two caveats prithvi shared: (1) bot must be added to channel before enabling monitoring, (2) custom instructions can be added to PROMPTLESS.md in Agent KB.

Source: https://promptless.slack.com/archives/C0AH39RBSN4/p1778860399041099?thread_ts=1778857795.403239&cid=C0AH39RBSN4


To enable passive listening:

1. Edit your Slack trigger project
Expand All @@ -97,6 +101,10 @@ To enable passive listening:
Passive listening is completely opt-in and only applies to channels you explicitly select. Promptless cannot access private channels unless it has been specifically invited to those channels.
</Warning>

<Tip title="Customizing Behavior">
If you want Promptless to follow specific instructions when processing messages in a monitored channel, add those instructions to your [Agent KB](https://app.gopromptless.ai/settings/knowledge) 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.
</Tip>

## Configuration

Configure Slack triggers in your [project settings](https://app.gopromptless.ai/projects):
Expand Down
Loading