Slack Integration Guide
Learn how to connect your Slack workspace to Playbott for real-time customer support alerts, agent escalation, and bi-directional message synchronization.
Connecting Playbott with Slack
The Playbott Slack integration bridges your customer-facing chat widget and internal team workflows. It streams live customer conversations, automated AI escalations, and ticket notifications directly into your team's Slack channels, allowing support agents to respond in real time without leaving Slack.
Bi-directional synchronization ensures messages sent from Slack appear instantly in the visitor's chat widget, while visitor replies update the corresponding Slack thread immediately.
Prerequisites
Before connecting your workspace:
- Playbott Administrator: Ensure you have an Organisation Admin role in your Playbott workspace.
- Slack Permissions: Ensure your Slack user account has permission to install apps or approve app installations in the target Slack workspace.
Step 1: Install the Playbott Slack App
To connect your organization to Slack:
- Sign into your Playbott Dashboard.
- Navigate to Organisation Settings → Integrations.
- Locate the Slack integration card and click Connect Slack.
- You will be redirected to Slack's secure OAuth authorization page.
- Select the destination Slack workspace and review the requested permissions.
- Click Allow to complete the installation.
Upon successful authorization, the integration status will display as Connected with your Slack team name.
Create a dedicated, private Slack channel (such as #support-live or #customer-escalations) specifically for Playbott alerts before installing the app.
Step 2: Configure Notification Channels
Once connected, configure where notifications and escalated tickets are routed:
- New Ticket Alerts: Receive immediate notifications when visitors open a new support request.
- AI Escalation Alerts: Ping on-call engineers or team leads when the AI assistant detects high-urgency keywords or sentiment triggers.
- SLA Breach Warnings: Post automated alerts when high-priority tickets approach their response time limit.
Step 3: Connect Agent Personal Slack Profiles (Optional)
Individual support agents can link their personal Slack profiles to receive direct assignment alerts:
- In the Playbott Console, click your profile avatar and navigate to Profile Settings.
- Under Slack Profile Connection, click Link Slack Account (or enter your unique Slack User ID).
- Authorize your personal user account.
When a customer ticket is assigned to you, Playbott sends a direct Slack notification with a link to jump straight into the ticket console.
Bi-Directional Message Flow
When a visitor opens a chat on your website:
Visitor sends message
↓
Playbott AI evaluates intent
↓ (Escalation / Human Request)
Slack alert posted to #support-live
↓
Agent replies in Slack thread
↓
Message synced to visitor chat widget in real time
Support agents can resolve tickets, add internal notes, or reassign queues directly using Slack message shortcuts.
Security & Permission Scopes
The Playbott Slack App requests minimal permissions required for operation:
| Scope | Purpose |
|---|---|
chat:write | Sends notification messages and syncs agent replies to threads. |
channels:read | Lists public channels to let admins select alert destinations. |
groups:read | Allows routing to private support channels where the bot is invited. |
users:read | Resolves agent email addresses to match Playbott user accounts. |
Playbott never reads or scans messages in channels where the app has not been explicitly invited. All API communication is encrypted in transit over HTTPS/WSS.
Troubleshooting
Slack installation displays "Workspace Not Allowed"
Ensure your Slack workspace administrator has permitted third-party app installations, or request authorization from your Slack workspace owner.
Replies in Slack not appearing in chat widget
Verify that the bot user has been invited to the channel (/invite @Playbott). If the channel is private, the bot must be an active member of the channel to receive thread replies.
Next Steps
- Learn how to embed the widget in the Widget Installation Guide.
- Configure launcher colors and themes in Widget Customization & Styling.
Frequently Asked Questions
Can support agents reply to customer chats directly from Slack?
Yes. When customer inquiries escalate or require human intervention, agents can reply within the dedicated Slack thread. Messages sync instantly back to the customer's chat widget.
Do support agents need individual Slack connections?
Connecting individual accounts under Profile Settings is optional but recommended. It enables personalized assignment pings and maps agent identities directly to customer-facing replies.
What permissions does the Playbott Slack App require?
Playbott requests minimal standard scopes: chat:write (to post notifications and replies), channels:read (to select alert channels), and users:read (to match agent profiles).
Ready to deploy Playbott on your website?
Get started in minutes with our embedded AI chat widget and omnichannel ticketing.