Slack Integration Setup Guide

This guide walks you through connecting Lathe Studio to Slack for notifications and team collaboration.

---

Prerequisites#

• Slack workspace
• Permission to install apps in your workspace
• Project admin access in Lathe Studio

---

Overview#

The Slack integration enables:

• Test Run Notifications: Get notified when test runs are completed
• Build Alerts: Receive alerts when builds are ready for testing
• Release Updates: Track release status changes
• Team Mentions: Notify team members when they're assigned to test

---

Connecting Slack#

Step 1: Install the Lathe Studio App

1. In Lathe Studio, go to Project Settings > Integrations > Slack
2. Click Connect to Slack
3. You'll be redirected to Slack to authorize the app
4. Select the channel where notifications should be posted
5. Click Allow

Step 2: Configure Notifications

After connecting, configure which events trigger notifications:

Step 3: Test the Integration

1. Complete a test run in Lathe Studio
2. Check the configured Slack channel
3. You should see a notification with test run details

---

Notification Format#

Test Run Completed

🧪 Test Run Completed: Smoke Tests - Build 245

Project: E-commerce Platform
Build: 245 (v2.4.1)
Release: March Sprint

Results:
✅ Passed: 42
❌ Failed: 3
⚠️ Blocked: 1
⏭️ Skipped: 4

View Run: https://lathestudio.dev/projects/.../runs/...

Build Ready for Testing

🔨 New Build Available: Build 246

Project: E-commerce Platform
Branch: main
Commit: a1b2c3d

This build needs to be assigned to a release for testing.

Assign to Release | View Build | Reject

---

Channel Configuration#

Project Channels

You can configure different Slack channels for different projects:

1. Go to Project Settings > Integrations > Slack
2. Click Add Channel
3. Select the Slack channel
4. Choose notification types for this channel

DM Notifications

Team members can receive direct messages for:

• Test assignments
• Mentions in test comments
• Release reminders

To enable:

1. Each team member connects their Slack account in Profile Settings
2. Select "Enable DM notifications"

---

Slash Commands#

Use Slack slash commands to interact with Lathe Studio:

---

Troubleshooting#

Notifications not appearing

1. Verify the Lathe Studio app is installed in your workspace
2. Check the bot is invited to the channel
3. Ensure notification settings are enabled for the event type
4. Verify the project is linked to the channel

Bot not responding to commands

1. Check the bot is in the channel
2. Verify the command syntax is correct
3. Ensure your Slack account is linked to Lathe Studio

Rate limiting

Slack has rate limits for bot messages. If you see delays:

1. Reduce notification frequency
2. Disable non-critical notifications
3. Use daily digests instead of real-time notifications

---

Security#

• OAuth tokens are encrypted at rest
• Lathe Studio only requests necessary permissions
• No message content is stored from Slack
• Users can disconnect at any time
• Workspace admins can revoke app access in Slack

---

Unlinking Slack#

To disconnect:

Organization Level

1. Go to Organization Settings > Integrations > Slack
2. Click Disconnect
3. Confirm disconnection

Project Level

1. Go to Project Settings > Integrations > Slack
2. Click Remove Integration
3. Or remove specific channels

Note: Removing Slack integration stops all notifications. Previously sent messages remain in Slack.

---

Advanced Configuration#

Custom Message Templates

Enterprise customers can customize notification messages:

1. Go to Organization Settings > Integrations > Slack > Advanced
2. Edit message templates using Liquid syntax
3. Available variables: {{project.name}}, {{run.status}}, etc.

Webhook URLs (Enterprise)

For custom integrations:

1. Create an incoming webhook in Slack
2. Paste the URL in Project Settings > Integrations > Slack > Webhook
3. Select events to send

---

For additional help, contact support.