Microsoft Teams
List teams and channels, read channel messages, and send messages
Connect Microsoft Teams when a project needs channel data or needs to post a notification to a work or school tenant. Swarmz supports shared project and published app-user connections.
Available operations
| Operation | What it does | Permission | Limit per minute |
|---|---|---|---|
list_teams | Lists up to 50 joined teams | Read teams and channels | 30 |
list_channels | Lists channels in one team | Read teams and channels | 30 |
list_channel_messages | Reads up to 50 messages from one channel | Read channel messages | 20 |
send_channel_message | Sends one plain-text channel message | Send channel messages | 10 |
Connect Microsoft Teams
An administrator first configures Microsoft OAuth application and enables Microsoft Teams under Admin > Settings > Integrations. The Microsoft tenant may require an administrator to approve channel-message permissions.
Ask the AI for the channel workflow and name who owns the connection. Examples:
- “List the teams and channels available to our shared Microsoft account.”
- “Post a plain-text notification to the Operations channel when an order fails.”
Choose Connect new, approve the requested Microsoft permissions, then select Continue. For a published app-user connection, provide the app's final HTTPS origin first. See Published app-user connectors.
Verify Microsoft Teams
- List teams and confirm one expected team.
- List that team's channels and record the test channel ID.
- Read recent messages from the test channel.
- Send
Swarmz connector test, then confirm it appears in Teams. - Remove the test message in Teams if your role permits it.
The authorized account can access only teams and channels allowed by Microsoft. If a team is missing, confirm membership and tenant consent, then reconnect. Disconnecting does not remove messages already sent.
Messages sent by this connector are plain text and limited to 16 KiB. Generated browser code must not receive Microsoft access or refresh tokens.