Slack is a messaging platform for teams. PlayerZero’s Slack integration lets you interact with AI Players directly from Slack — starting investigations from message threads, chatting with Players in DMs, and running workflows with optional playbook guidance.Documentation Index
Fetch the complete documentation index at: https://playerzero.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
What You Can Do
Once connected, you can:- Chat with Players in DMs — Send messages directly to the PlayerZero bot to ask questions about your codebase, debug issues, or investigate problems
- @mention in channels — Mention the PlayerZero bot in any channel to start a conversation. The bot creates a Player session and responds in a thread.
- Start investigations from messages — Use the Ask PlayerZero message shortcut to send any message thread to a Player, with full thread context automatically captured and optional workflow or playbook selection
- Use the
/ask_playerzerocommand — Type/ask_playerzeroin any channel to open the Ask PlayerZero modal without needing to right-click a message - Open in Chat — Link an existing PlayerZero session to a Slack channel from the PlayerZero UI, so you can continue a conversation in Slack
- Receive notifications in channels — Get workflow stage approval requests, Player summaries, and other notifications delivered to your team’s channels
Ask PlayerZero
Message Shortcut
Right-click any message (or use the ⋯ menu) and select Ask PlayerZero to send it to a PlayerZero AI Player.- Select Ask PlayerZero from the message shortcut menu
- Choose a project (if you have more than one)
- Optionally select a workflow to start the Player in a specific workflow stage, or a playbook to guide the Player’s approach
- Add any additional context to supplement the thread content
- Click Create
Slash Command
Type/ask_playerzero in any channel to open the same Ask PlayerZero modal directly. Any text you include after the command is pre-filled into the message field.
The command creates a new thread in the current channel and links it to the Player session. This is useful when you want to start an investigation without a specific message to reference.
Global Shortcut
Open Slack’s global shortcuts menu and select Ask PlayerZero to start a new Player session without message context.- Open the global shortcuts menu
- Select Ask PlayerZero
- Choose a project and optionally a workflow or playbook
- Provide a message describing your question or task
- Click Create
How Thread Context Works
When you trigger the message shortcut from a message that’s part of a thread, PlayerZero reads the parent message of that thread and includes its content alongside your additional context. This means the AI Player understands the full conversation without you needing to copy and paste.Workflow Stage Approvals
When an AI Player needs approval to move to the next workflow stage, PlayerZero delivers an approval notification to Slack. These notifications appear in the thread where the Player was started (if it originated from Slack) and in any channels configured for that workflow stage. The notification includes:- An Approve button to approve the transition immediately
- An Approve with message button to add context, select a playbook, or provide instructions before approving
- A View in PlayerZero link to open the full Player session
Open in Chat
You can link any PlayerZero session to a Slack channel directly from the PlayerZero UI. From a Player session in PlayerZero, click Open in Chat and select a Slack channel. PlayerZero creates a new thread in that channel linked to the Player — messages in the thread are forwarded to the Player, and the Player’s responses appear in the thread. If the Player is already connected to a Slack thread, clicking Open in Chat takes you directly to that thread instead.Receive Notifications
PlayerZero delivers notifications to Slack channels based on your project and workflow configuration. Notifications include:- Workflow stage approval requests when a Player needs human approval to continue
- Player response summaries posted to threads where investigations were started
- Notifications from monitor-initiated Players when a monitor triggers a new investigation and delivers results to a configured channel
Scopes & Permissions
PlayerZero requests only the permissions needed for AI agents to assist with debugging, communication, and issue management. We follow the principle of least privilege — each permission directly enables a specific capability.
| Scope | Why It’s Needed |
|---|---|
app_mentions:read | @mention responses — Allows PlayerZero to detect when someone mentions the bot in a channel and respond |
channels:history | Thread context — Enables reading message threads to provide full context when a shortcut is triggered from a channel |
channels:join | Channel access — Allows the bot to join public channels where it needs to deliver notifications or respond to mentions |
channels:read | Channel discovery — Lets PlayerZero list available channels during setup so you can choose where to receive notifications |
chat:write | Responses and notifications — Enables sending agent responses, investigation results, and approval notifications |
chat:write.customize | Attributed messages — Allows the bot to send messages on behalf of team members (e.g., “Alice (via PlayerZero)”) when relaying messages from the PlayerZero UI |
commands | Slash command and shortcuts — Required for the /ask_playerzero command and the Ask PlayerZero shortcuts |
files:write | File sharing — Enables sharing files (e.g., diagrams, reports) generated by AI agents |
groups:history | Private channel threads — Same as channels:history but for private channels |
groups:read | Private channel info — Same as channels:read but for private channels |
im:history | DM conversations — Enables reading direct messages with the bot |
im:write | DM initiation — Enables the bot to open direct message conversations |
mpim:history | Group DM conversations — Enables participating in group direct message threads |
users:read | User mapping — Allows matching Slack users to PlayerZero accounts for proper attribution |
users:read.email | Email matching — Uses email addresses to link Slack identities with PlayerZero user accounts |
Setup
Setup starts in PlayerZero — no pre-configuration in Slack is required. The Slack connection is managed under Collaboration, not the Ticketing page (which is used for tools like Jira and Linear).
- In PlayerZero, navigate to Settings → Collaboration
- Click the Slack card to open its detail page
- Click Enable — a popup window will open for Slack authorization
- Sign in to Slack and authorize PlayerZero in your workspace
- After authorization, the popup closes and you’ll see the Slack detail page with configuration options
/ask_playerzero command, message shortcuts, DMs with the bot, and @mention responses. No additional configuration is needed beyond the initial connection.
Channel Access
The PlayerZero bot automatically joins public channels when it needs to deliver a notification or respond to a mention. No manual invitation is required for public channels. For private channels, you need to manually invite the bot by typing/invite @PlayerZero in the channel before PlayerZero can post there.
Notification Configuration
Once Slack is connected, you can configure where notifications are delivered at the organization and project level. Organization-level defaults:- Set a default Slack channel for notifications from the Collaboration settings page
- Control which projects are authorized to use the Slack connection — either all projects or a specific set
- Each project can configure notification channels independently
- Assign different Slack channels to different workflow stages — for example, route approval requests to
#support-triageand engineering escalations to#eng-alerts - Enable or disable workflow notifications (approval requests, stage transitions) per project
- Optionally restrict notifications to business hours based on your team’s timezone
- Notifications generated outside business hours are held and delivered when business hours resume