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

# Apostra in Microsoft Teams

> How to use Apostra in Microsoft Teams: install the shared Apostra app, confirm that your Teams account is yours, and pick the account a chat uses.

The Apostra Teams app lets people talk to Apostra in Microsoft Teams. Apostra is
one shared app for every customer. You install it; you never register a
Microsoft application of your own.

> [!NOTE]
>
> Apostra in Teams is in a pilot. It is not in the Microsoft Teams store yet.
> To try it in your Microsoft 365 tenant, ask
> [Apostra support](https://docs.apostra.com/v3/support.md).

## Install

A Teams admin installs the app for your tenant, or for a team. Anyone who can
install apps in Teams can add it to their own chats. Installing the app does not
connect it to an Apostra account: a tenant ID alone never picks an account.

## Confirm your Teams account

Your Teams profile is set by your own organization, so Apostra never links you
to an Apostra login from it. Instead you confirm once:

1. Message Apostra in a personal chat. The first time, Apostra replies with a
   link, only to you and only in that chat. It never posts the link in a
   channel.
2. Open the link and sign in to Apostra in your own browser. The page says which
   Teams account asked. Choose **Confirm** only if you just wrote to Apostra in
   Teams yourself. If you did not, choose **Not me** and tell your account
   admin; the link expires on its own.
3. After you confirm, Apostra answers that Teams account as you, with the access
   your Apostra login already has, from your next message.

The link works once and for 24 hours. The first login that opens it owns it:
from then on only that login can read or confirm it, and anyone else sees "We
could not find this link". If you write to Apostra again before you confirm,
Apostra shows you the same link, so a repeated message never cancels a page you
have open. If you open the link with the wrong login, send `/link` in the chat
and Apostra sends you a new one; the old link stops working, so only send
`/link` when you want a new link. After the 24 hours pass, your next message gets
a new link.

A Teams account links to one login. If it is already linked to a different
login, the page says so and does not change the link. Ask
[Apostra support](https://docs.apostra.com/v3/support.md) if you need to move a Teams account to another
login.

## Choose the account a chat uses

Your personal chat needs no team set up. It runs in an account you belong to:

* If your login belongs to one account, Apostra uses it.
* If your login belongs to several, Apostra asks which one to use before it runs
  anything on an account. Your choice is saved for that chat, and Apostra checks
  on every message that you still belong to it. Send `/account` to switch.

Apostra never picks an account for you when you belong to several.

## Teams and channels

An @mention of Apostra in a team or channel that is not connected to an account
gets only a fixed reply. Apostra reads no account data and runs nothing there.
Connecting a team to an account is not available yet.

## Questions

Email [support@apostra.com](mailto:support@apostra.com), or see
[Get support](https://docs.apostra.com/v3/support.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.