Set Up Teams Connector

What you'll build

An authenticated connection to a Microsoft Teams channel so your agent can post updates, reply to threads, and read messages. Learn more → Send Notifications. Time: ~5 minutes.

Prerequisites

• An agent created in the Azure SRE Agent portal
• A Microsoft Teams account with access to the target channel
• A Teams channel URL (you'll get this during setup)
• Contributor role on the agent's resource group (requires Microsoft.Web/connections/write and Microsoft.Authorization/roleAssignments/write)
• A managed identity configured on the agent

---

Step 1: Navigate to Connectors

1. Open your agent in the Azure SRE Agent portal
2. In the left sidebar, expand Builder
3. Select Connectors

---

Step 2: Add a Teams connector

1. Click Add connector in the toolbar
2. In the connector picker, select Send notification (Microsoft Teams)
3. Click Next

One Teams connector per agent

Your agent can have one Teams connector at a time. If a connector already exists, the card is disabled with the message "Your agent can only have one Teams connector."

---

Step 3: Sign in to Microsoft Teams

1. Wait for the permission check to complete
2. Click Sign in to Microsoft Teams
3. Complete the OAuth authentication in the popup window
4. On success, you'll see a Connected as card showing your email address with a green checkmark

Checkpoint: Green checkmark with your email address visible. If you see a permissions warning, verify you have Contributor role on the resource group.

Popup blocker

If the authentication dialog doesn't appear, check that your browser isn't blocking popups from sre.azure.com.

---

Step 4: Paste Teams channel link

1. In Microsoft Teams, right-click the target channel and select Get link to channel
2. Copy the channel URL
3. Back in the connector setup form, paste the URL into the Teams channel link field

The URL should look like:

https://teams.microsoft.com/l/channel/19%3A...%40thread.tacv2/channel-name?groupId=...

The form automatically extracts the channel ID and group ID from this URL.

Checkpoint: The form accepts the URL without error. If the URL is invalid, the field clears the extracted IDs — verify you copied the link from "Get link to channel" and not from a meeting or chat link.

---

Step 5: Select managed identity and save

1. From the Managed identity dropdown, select a managed identity (system-assigned or user-assigned)
2. Click Next to proceed to the Review + add step
3. Verify your connector details
4. Click Add connector to create the connector

Checkpoint: A toast notification confirms the connector was created successfully. Your connector appears in the connectors list.

---

Step 6: Test your Teams connector

Ask your agent:

Post to our Teams channel: "SRE Agent is connected and ready for notifications"

Your agent formats the message as HTML and posts it to the configured Teams channel.

Checkpoint: The agent shows a tool card confirming the message was posted. Check your Teams channel to verify the message appeared.

---

Edit or remove the connector

Edit

1. In the connectors list, click the ⋯ (more actions) menu on the Teams connector row
2. Select Edit connector
3. The edit dialog opens — you can change the Teams channel link, re-authenticate, or update the managed identity
4. Click Save

Delete

1. Click ⋯ on the connector row → Delete connector, or select the checkbox and click Remove in the toolbar
2. Confirm the deletion

After deleting, your agent can no longer post to Teams. You can add a new Teams connector at any time.

---

What you learned

• How to add a Teams connector using OAuth and a channel link
• How to get and paste a Teams channel URL
• How to verify the connector by posting a test message
• What Teams tools become available to your agent

Troubleshooting

Issue	Solution
Channel link not accepted	Ensure the URL is from Get link to channel in Teams, not a meeting or chat link
Permissions warning	You need Microsoft.Web/connections/write and Microsoft.Authorization/roleAssignments/write roles on the resource group
OAuth popup blocked	Allow popups from sre.azure.com in your browser settings
Message doesn't appear in channel	Verify the channel URL is correct and your signed-in account has access to that channel
No managed identities in dropdown	Click Add identity to configure one in the Azure portal, then click the refresh button

Related

Resource	What you'll learn
Send Notifications →	How your agent uses Outlook and Teams for contextual notifications
Set Up Outlook Connector →	Connect Outlook for email notifications
Create a Scheduled Task →	Automate Teams notifications on a schedule