Microsoft Teams

Overview

Firefly integrates with Microsoft Teams to provide rich notifications for various events and alerts. This integration enables teams to receive real-time updates about infrastructure changes, policy violations, drift detection, and other important events directly in their Teams channels.

Prerequisites

• A Microsoft Teams workspace with administrative access

• Appropriate permissions to create webhooks

• Channels where you want to receive Firefly notifications

Setup Procedure

1. Follow Microsoft's official guide to create an Incoming Webhook: Microsoft Teams Webhook Guide

2. In Firefly, select Settings > Integrations

3. Select Add New > Teams

4. Enter a descriptive name in the Nickname field

5. Enter the Webhook URL

6. Select Next > Done

Features Enabled

• Real-time Notifications: Receive immediate alerts for important events

• Rich Message Cards: Detailed, formatted messages with direct links to Firefly

• Customizable Alerts: Configure which events trigger notifications

• Channel-specific Routing: Send different types of alerts to different channels

• Interactive Messages: Click through to Firefly directly from Teams notifications

Best Practices

• Create dedicated channels for different types of notifications

• Configure notification rules to avoid alert fatigue

• Regularly review and update notification settings

• Ensure the webhook connector remains active

• Test the integration after setup to verify message delivery

Example Notifications

Teams messages from Firefly are formatted as rich cards and may include:

• Alert notifications: "🚨 Firefly: New High Drift detected in Azure – 2 VMs have configuration drift"

• Policy violations

• Infrastructure changes

• Asset status updates

Troubleshooting

1. Webhook Issues:

   • Verify the webhook URL is valid and not expired

   • Check channel permissions

   • Confirm the webhook connector is active

2. Notification Issues:

   • Review notification rules in Firefly

   • Check Teams channel message settings

   • Verify channel accessibility for team members

3. Message Delivery:

   • Ensure the channel exists and is accessible

   • Check if the webhook URL was copied correctly

   • Verify network connectivity between Firefly and Teams