How to set up Microsoft Teams

This guide will provide step-by-step instructions on how to set up a Microsoft Teams Workflow with Webhooks, enabling you to easily view Fabric Events and Metrics. You can use the URI in the following POST fabric/v4/streamSubscriptions request

curl -X POST
'https://api.equinix.com/fabric/v4/streamSubscriptions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <bearer_token>' \
--data '{
"type": "STREAM_SUBSCRIPTION",
"name": "<teams_subscription_name>",
"description": "<teams_subscription_desc>",
"stream": {
"uuid": "<stream_id>"
},
"sink": {
"uri": "<teams_webhhook_uri",
"type": "TEAMS"
}
}'

Step-by-Step Instructions 

1. Create a Microsoft Teams’ Channel

• Log in to your Microsoft Teams, navigate to Create and join teams and channel. 
• Create a Channel under the desired Teams for Equinix Observability to send Events and Metrics. This step assumes that a Teams exist or is created.

 

1.1 Select a Team

• Add the channel to a team: Select a team to add the channel under.

1.2 Provide a Name for the Channel

• Channel Name: Provide a name to identify the channel.

1.3 Provide a Description for the Channel

• Description: Provide a description to identify the channel.

1.4 Select Channel Policy Type

• Choose a channel type: Select Policy type for the channel with Standard, Shared or Private.

Refer to Microsoft Teams Channel Policies Documentation: https://learn.microsoft.com/en-us/microsoftteams/teams-policies.

• Click Create to continue.

2. Create a Microsoft Workflow for Webhooks

• Under the Channel created, select Workflows in the dropdown menu.
• In the Workflow, click search for "Post to a channel when a webhook request is received".
• Click "Post to a channel when a webhook request is received" under the Template results.

2.1 Provide a Name for the Microsoft Workflow's Webhook

• Name: Provide a name or leave the default name for the Microsoft's Webhook Workflow.
• Click Next to Continue.

2.2 Confirm the Microsoft Workflow's Webhook created successfully

• At the current step, Microsoft Workflow will create a URL.
• Click done to complete the workflow creation.

Please note that your enterprise will need to enable Microsoft Workflows.

3. Configure the workflow Webhook to Post Message to a Channel

• Under the channel created, select Workflows in the dropdown menu.
• Click manage.
• Under the Workflow created, click edit in the dropdown.

3.1 Add Post message in a chat or channel step to Workflow

• If necessary, remove any preconfigured Microsoft Workflow Steps added from the template and leave only the "When a Teams webhook request is received" step.
• Click +New Step Button
• Select and configure Post Message in a Chat or Channel Step:
• Post as: Select Flow Bot
• Post in: Select channel 
• Team: Select the Team where you created a channel
• Channel: Select the channel
• Message: Add Dynamic Content body.
• Click Save

4. Save the Microsoft Workflow URI

• Ensure that the Microsoft Workflow Webhook HTTP POST URL generated during this process are saved securely. The URL are required for further integration or data ingestion processes.

4.1 Copy the API and Application Keys

• Once the setup is complete, a URL value will be generated.
• Copy the URL to your clipboard, as it will be needed later for the POST streamSubscription API in Stream Observability.

4.2 Start receiving Fabric Events and Metrics in Mic.

• Navigate to Metrics Explorer and search the Fabric Metrics for Observability.