Beta

Microsoft Teams Integration

Send Tape workflow notifications directly to Microsoft Teams channels to keep your team informed of important events, errors, and status updates.

Setting Up Microsoft Teams Integration

Step 1: Create an Incoming Webhook in Microsoft Teams

First, you need to create an incoming webhook in your Teams channel:

  1. Navigate to the Teams channel where you want to receive notifications
  2. Click the ”…” (more options) button next to the channel name
  3. Select “Connectors” from the dropdown menu
  4. Search for “Incoming Webhook” and click “Configure”
  5. Provide a name (e.g., “Tape Notifications”) and upload an icon if desired
  6. Click “Create”
  7. Copy the webhook URL that appears - you’ll need this for the next step

Step 2: Add Microsoft Teams as a Destination

Now, add Microsoft Teams as a destination in TapeAlert:

  1. Navigate to your webhook in TapeAlert
  2. Click “Add Destination”
  3. Select “Microsoft Teams” as the destination type
  4. Enter a name for this destination (e.g., “Dev Team Channel”)
  5. Paste the webhook URL you copied from Microsoft Teams
  6. Click “Save”

Testing Your Integration

After setting up the integration, test it to ensure it’s working correctly:

  1. On your destination page, click the “Test” button
  2. A test notification will be sent to your Teams channel
  3. Verify that the notification appears in the channel

Notification Format

Microsoft Teams notifications are formatted as adaptive cards that include:

  • Header: Clear identification of the notification type with logo
  • Content: Details about the event or error
  • Facts Section: Key information presented in a structured format
  • Action Buttons: Direct links to relevant Tape workflows or records

Configuring Notification Details

You can customize how notifications appear in Microsoft Teams:

  1. Edit your Teams destination
  2. Adjust the notification configuration options:
    • Display Name: Change how the sender name appears
    • Show Workflow Links: Toggle display of direct workflow links
    • Include Record Links: Toggle display of record links

Troubleshooting

If you’re experiencing issues with Microsoft Teams integration:

Notifications Not Appearing

  • Verify that the webhook URL is correct and hasn’t expired
  • Check if you still have permission to post to the channel
  • Ensure your organization allows incoming webhooks
  • Test the destination directly from TapeAlert

Note: Webhook URLs are stored in encrypted form for security reasons. This is why they appear as obfuscated text in the edit window and webhook detail card. The actual URL is properly decrypted when sending notifications.

Format Problems

  • Microsoft Teams has message size limitations
  • Complex notifications may be simplified for display
  • If images don’t appear, check your network’s content filtering rules

Best Practices

  • Create Focused Channels: Set up dedicated channels for different notification types
  • Prioritize Important Notifications: Only send critical alerts to main team channels
  • Use Descriptive Names: Name your destinations clearly for easy identification
  • Regular Testing: Periodically verify that your webhooks are still working

Next Steps