All Docs
Microsoft Teams Integration Setup Guide

Microsoft Teams Integration Setup Guide

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

Prerequisites#

  • Microsoft Teams account
  • Permission to add connectors/apps to your team
  • Project admin access in Lathe Studio

Overview#

The Microsoft Teams 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 Collaboration: Discuss test results in Teams channels

Connecting Microsoft Teams#

Step 1: Add Incoming Webhook to Teams

  1. In Microsoft Teams, go to the channel where you want notifications
  2. Click the ... (more options) next to the channel name
  3. Select Connectors
  4. Search for Incoming Webhook
  5. Click Add
  6. Give it a name: "Lathe Studio"
  7. Upload the Lathe Studio logo (optional)
  8. Click Create
  9. Copy the webhook URL

Step 2: Configure in Lathe Studio

  1. Go to Settings → Integrations → Microsoft Teams
  2. Paste the webhook URL
  3. Click Save

Step 3: Configure Notifications

Select which events trigger Teams notifications:

EventDescriptionDefault
Test Run CompletedWhen a test run is marked completeEnabled
Test Run SubmittedWhen a tester submits resultsEnabled
Build CreatedWhen a new build is availableEnabled
Release ReleasedWhen a release is shippedEnabled
Test Case FailedWhen a test fails (immediate)Disabled
Daily SummaryDaily digest of activityDisabled

Step 4: Test the Integration

  1. Click Send Test Message in Lathe Studio
  2. Check the Teams channel
  3. You should see a test notification

Notification Format#

Test Run Completed

Card Title: Test Run Completed

Body:

  • Test Run: Smoke Tests - Build 245
  • Project: E-commerce Platform
  • Results: ✅ 42 Passed | ❌ 3 Failed | ⚠️ 1 Blocked
  • [View Run] [View Report]

Build Ready for Testing

Card Title: New Build Available

Body:

  • Build: 246 (v2.4.1)
  • Branch: main
  • Status: Ready for testing
  • [Assign to Release] [View Details]

Channel Configuration#

Microsoft Teams supports one incoming webhook connection per organization — notifications are delivered to the channel whose webhook URL you pasted in Lathe Studio.

To notify different groups about different projects, create custom notification rules and scope each rule to the relevant project. All Teams notifications for your organization are delivered to the connected channel.

Message Cards

Notifications use Teams connector Message Cards:

  • Test result summaries
  • "View" links back to the run or build in Lathe Studio
  • Status indicators

Troubleshooting#

Notifications not appearing

  1. Verify the webhook URL is correct
  2. Check the connector is active in Teams
  3. Ensure notification settings are enabled
  4. Try sending a test message

Webhook URL errors

If you see "Invalid webhook URL":

  1. Regenerate the webhook in Teams
  2. Update the URL in Lathe Studio
  3. Ensure the URL starts with https://

Rate limiting

Microsoft Teams has rate limits for connectors:

  • Maximum 30 messages per 60 seconds
  • If exceeded, messages may be delayed or dropped

To avoid this:

  1. Reduce notification frequency
  2. Use daily digests instead of real-time notifications
  3. Batch similar notifications

Security#

  • Webhook URLs are stored in the database and scoped by organization; they are encrypted at rest
  • URLs contain unique tokens for authentication
  • No Teams credentials are stored
  • Users can remove the connector at any time
  • Team owners can manage connector permissions

Unlinking Microsoft Teams#

To disconnect:

Method 1: Remove Connector in Teams

  1. Go to the channel in Teams
  2. Click ... > Connectors
  3. Find "Incoming Webhook"
  4. Click Configured
  5. Find the Lathe Studio webhook
  6. Click Remove

Method 2: Remove in Lathe Studio

  1. Go to Settings → Integrations → Microsoft Teams
  2. Click Remove Integration
  3. Confirm disconnection

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

Advanced Configuration#

Power Automate Integration

Use Microsoft Power Automate for advanced workflows:

  1. Create a flow triggered by Lathe Studio webhook
  2. Add actions like:
    • Send email notifications
    • Create Planner tasks
    • Update SharePoint lists
    • Post to other channels

For additional help, contact support.

← All DocsSettings →