Slack integration

Used for: Triggers and Context

Promptless integrates with Slack through our official Slack App, enabling automated documentation updates based on team communication and support conversations.

Promptless does not archive or store your Slack messages.

Disclaimer: Promptless uses LLMs from OpenAI and Anthropic that have the potential to generate inaccurate results.

Installation

1. Click “Connect Slack” from the integrations page.

2. You’ll be redirected to Slack to install the Promptless app. Be sure to select the right workspace to install Promptless.

3. Review and approve the requested permissions for the Promptless Slack app. Promptless requires these permissions to be able to be triggered from the right events in Slack and to notify your team when updates are available.

Understanding Slack Permissions

By default, Promptless only accesses Slack content when you explicitly trigger it by tagging @Promptless or using the “Update Docs” message action. If you enable passive listening, Promptless monitors only the specific channels you select.

Key permissions

Promptless requests these Slack permissions:

• channels:read and groups:read — List available channels and groups
• chat:write — Send messages and notifications to channels where Promptless is invited
• files:write — Attach diff files to Slack threads when notifying about documentation changes
• links:read and links:write — Render preview cards when a Promptless suggestion link is shared in Slack
• users:read — Look up user information for mentions and notifications

The files:write permission lets Promptless attach diff files directly in Slack threads, so you can review proposed changes without leaving Slack. If this permission isn’t granted, Promptless links to the dashboard instead.

The links:read and links:write permissions let Promptless render a preview card when someone shares a suggestion link in Slack. If links:write isn’t granted, the link posts as plain text with no preview card.

4. Verify that Slack is connected in the integrations page.

Support channel

After connecting Slack, you’ll receive a Slack Connect invitation from the Promptless team. Accept it to join a shared support channel where you can ask questions, get help, and share feedback.

Update Slack permissions

As Promptless adds Slack features, the app sometimes needs new permissions. If you connected your workspace before a permission was introduced, your existing connection lacks that permission until you grant it.

To add new permissions without disconnecting, click Reconnect on the connected Slack card on the integrations page. Promptless re-runs Slack authorization so you can approve the updated permissions, and your existing connection stays intact—channel memberships and configuration are preserved. Reconnect whenever a Slack feature stops working because a permission is missing.

What you can do with Slack

Once connected, you can use Slack for:

• Triggers: Tag @Promptless or use message actions to trigger documentation updates
• Context Sources: Search Slack conversations for team discussions and decisions

Privacy and channel access

By default, Promptless only reads Slack content when you explicitly trigger it by tagging @Promptless or using the “Update Docs” message action. If you enable passive listening in your configuration, Promptless monitors only the specific channels you configure.

Add Promptless to private channels

Promptless cannot access private channels unless it has been specifically invited. To add Promptless to a private channel, tag @Promptless in that channel—Slack prompts you to invite the app.

This is required if you want to:

• Use a private channel as your notification channel for suggestions
• Trigger Promptless from messages in a private channel
• Enable passive listening on a private channel

Troubleshooting

Diff files not appearing in Slack threads

If Promptless notifications appear in Slack but diff files aren’t attached, your Slack integration may be missing the files:write permission. This can happen if you connected Slack before this permission was added to the Promptless app.

To fix this, re-authorize the Slack integration:

1. Go to the integrations page.
2. Click Reconnect on the connected Slack card.
3. Approve the requested permissions in Slack.

Reconnecting keeps your existing connection intact while granting the missing permission. After re-authorizing, diff files appear as thread attachments. If issues persist, contact help@gopromptless.ai.

Suggestion link previews not rendering in Slack

If sharing a Promptless suggestion link in Slack posts as plain text instead of a preview card, your Slack integration may be missing the links:write permission. This can happen if you connected Slack before this permission was added to the Promptless app. The Integrations page flags this connection as Needs reconnect.

To fix this, re-authorize the Slack integration:

1. Go to the integrations page.
2. Click Reconnect on the connected Slack card.
3. Approve the requested permissions in Slack.

Reconnecting keeps your existing connection intact while granting the missing permission. After re-authorizing, shared suggestion links render as preview cards. If issues persist, contact help@gopromptless.ai.

For more details about using Slack with Promptless, see Reviewing from Slack and Teams.