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 Project 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#

Project Channels

Configure different Teams channels for different projects:

  1. Go to Project Settings > Integrations > Microsoft Teams
  2. Click Add Channel
  3. Paste the webhook URL for the channel
  4. Choose notification types

Adaptive Cards

Notifications use Microsoft Adaptive Cards for rich formatting:

  • Test result summaries
  • Action buttons (View, Assign, Reject)
  • Colored status indicators
  • Collapsible details

Microsoft Teams App (Coming Soon)#

A dedicated Lathe Studio app for Microsoft Teams is in development. Features will include:

  • Tab views for test dashboards
  • Message extensions for quick test lookups
  • Bot commands for status checks
  • Meeting integration for test planning

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 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 Project 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

Custom Card Formatting

Enterprise customers can customize Adaptive Cards:

  1. Go to Organization Settings > Integrations > Microsoft Teams > Advanced
  2. Edit card templates using Adaptive Card JSON
  3. Preview changes before saving

For additional help, contact support.

← All DocsSettings →