> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Set up and use the Microsoft Teams integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Microsoft Teams

1. Go to Settings → Apps in Hyper
2. Select Microsoft Teams → Connect New
3. Complete OAuth and approve requested scopes

## Common capabilities

* Post messages and updates to channels
* Automate team collaboration and meeting management workflows
* Drive notifications and escalations

## Use in Chat

Enable Microsoft Teams in the tool selector to let agents read or post updates directly from conversations.

## Use in Agents

Add Microsoft Teams to an agent's toolkits, choose a connection, and require approval for posting if desired.

## Use in Flows

Add Teams nodes for notifications, approvals, and escalations. Combine with other integrations for end-to-end workflows.

## Troubleshooting

* Not posting: verify channel permissions and bot membership
* Missing messages: check scope coverage and channel access

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                | Description                                                                                |
| --------------------- | ------------------------------------------------------------------------------------------ |
| Create Channel        | Create a new channel using microsoft\_teams-create-channel                                 |
| List Channel Messages | List messages in a channel using Graph /teams/{teamId}/channels/{channelId}/messages/delta |
| List Channels         | List channels in a Microsoft Team using microsoft\_teams-list-channels                     |
| List Chat Messages    | List messages in a chat using Graph /chats/{chatId}/messages                               |
| List Chats            | List chats for the current user using Graph /chats?\$expand=members                        |
| List Joined Teams     | List all teams the current user has joined via Graph /me/joinedTeams                       |
| List Shifts           | List shifts for a Microsoft Team using microsoft\_teams-list-shifts                        |
| Send Channel Message  | Send a message to a channel using microsoft\_teams-send-channel-message                    |
| Send Chat Message     | Send a message to a chat using microsoft\_teams-send-chat-message                          |
