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

# Teams

> Trigger sessions by mentioning @Tembo in any Teams chat or channel.

<Frame>
  <img src="https://mintcdn.com/test-8862363a/piEJkAE0JIrRA6gF/images/integrations/teams.png?fit=max&auto=format&n=piEJkAE0JIrRA6gF&q=85&s=38e54d93a7f87526f86889849cc1de9e" alt="Microsoft Teams" width="2562" height="1441" data-path="images/integrations/teams.png" />
</Frame>

<Warning>
  Tembo for Microsoft Teams is currently in **sideload pilot**. The app is not yet published to the Microsoft Teams Store — partner organizations install it directly via a `.zip` package. A full marketplace listing is in progress.
</Warning>

## Features

* Create sessions by mentioning `@Tembo` in any chat or channel
* Specify repos, branches, and agents inline
* Thread context is automatically read
* PR notifications posted back to the originating Teams thread
* Works in personal chats, group chats, and team channels

## Installation

<Tip>
  The Microsoft Teams integration is currently available on a limited basis. To get started, [please reach out to the team at Tembo.io](https://book.avoma.com/tembo/tembo-demo/) to schedule setup for your organization.
</Tip>

## Usage

### Basic

```
@Tembo Fix the authentication bug in the login flow
```

### With options

```
@Tembo In owner/webapp on branch dev, add password strength validation
```

**You can specify:** repository, branch, and agent in plain text (for example: `owner/webapp`, `branch dev`, `agent gpt-5.4`).

### Multiple repositories

```
@Tembo Add user authentication in owner/frontend and owner/backend
```

Tembo creates separate PRs for each repo and coordinates changes.

### Thread context

Mention `@Tembo` in a thread reply and it reads the full conversation history for context.

### Iterate in Teams

After Tembo opens a PR, you can keep mentioning `@Tembo` in the same Teams thread to give feedback and iterate. No need to leave comments on the PR itself.

### Help

```
@Tembo help
```

Shows the available commands and supported options.

## Agents

See [Agents](/features/agents) for available Teams event triggers.

## Supported environments

| Cloud                    | Supported |
| ------------------------ | --------- |
| Microsoft 365 Commercial | Yes       |
| GCC                      | Yes       |
| GCC High                 | No        |
| DoD                      | No        |
| 21Vianet (China)         | No        |

## Advanced

<AccordionGroup>
  <Accordion title="Tembo not responding">
    Verify the app is installed in your Teams scope (personal / team / chat). If you installed it for **personal** only and are trying to use it in a team channel, install it again with the **team** scope.

    Also confirm the bot is allowed in your channel — some org policies restrict bot interactions in specific channels.
  </Accordion>

  <Accordion title="&#x22;Custom app upload&#x22; button is missing">
    Your Teams admin has not enabled custom app uploads for your tenant. Send them the link to the [Teams admin center setup policies](https://admin.teams.microsoft.com/policies/manage-app-setup-policies) and ask them to enable **Upload custom apps** on your setup policy. Changes may take up to 24 hours to take effect. <br /> <br /> Also be sure to check that the button is toggled to 'on' in your settings once it is located by your admin.
  </Accordion>

  <Accordion title="Wrong repository targeted">
    Set a default repository in your Tembo workspace settings, or specify the repository directly in your message (for example: `owner/repo`).
  </Accordion>

  <Accordion title="Updating to a new version">
    When a new version of the Tembo Teams package is released, download the latest `.zip` and repeat the upload steps. Teams will detect it as an update rather than a new install as long as the app ID is unchanged.
  </Accordion>

  <Accordion title="Need a different cloud (GCC High, DoD)">
    Tembo for Teams is not currently certified for GCC High, DoD, or 21Vianet clouds. If your organization needs Tembo in one of these environments, [contact us](https://tembo.io/contact).
  </Accordion>
</AccordionGroup>
