# Microsoft Teams

Source: https://docs.stacksync.com/ai-agents/genie-interfaces/microsoft-teams

Connect a genie to Microsoft Teams and talk to it in team channels or 1:1 chat.

Setting up Teams has two halves: your **Teams administrator** installs the Genie app into your Microsoft Teams organization, and a **Stacksync workspace admin** connects it to your genie.

### 1. Download the Genie app package

Download the app package below. It contains the Teams app manifest and icons.

<FileDownload name="Genie-Teams-v1.0.0.zip" href="/files/ai-agents/genie-teams-v1-0-0.zip" kind="archive" size="15KB" />

### 2. Install it in your Teams organization (Teams admin)

<Callout type="info">
  Only an Admin can upload the app on Microsoft Teams
</Callout>

Open **Teams** → **Store** → **Manage apps**

<figure>
  <img src="/images/ai-agents/microsoft-teams-apps-sidebar-button.webp" alt="Microsoft Teams with the Genies-Demo channel open and an arrow pointing to the Apps (+) button in the left sidebar." width="1600" height="924" loading="lazy" decoding="async" />

  <figcaption />
</figure>

<figure>
  <img src="/images/ai-agents/microsoft-teams-manage-your-apps.webp" alt="Microsoft Teams Apps page listing the Stacksync Genie app under &#x22;Built for your org&#x22;, with &#x22;Manage your apps&#x22; highlighted at the bottom." width="1600" height="1784" loading="lazy" decoding="async" />

  <figcaption />
</figure>

Click **Actions** → **Upload new app** and select the downloaded zip.

<figure>
  <img src="/images/ai-agents/microsoft-teams-upload-app-org-catalog.webp" alt="Teams &#x22;Upload an app&#x22; dialog with &#x22;Upload an app to your org's app catalog&#x22; highlighted, used to install the Genie app zip." width="1600" height="1127" loading="lazy" decoding="async" />

  <figcaption />
</figure>

Once uploaded, the app is available to your organization. Users find it in Teams under **Apps** → **Built for your org** → **Genie** → **Add**, and can also **Add it to a team** to use it in channels.

<Callout type="info">
  On newly created Microsoft 365 tenants, the app management section can take a while to finish provisioning. If the upload option is missing, try again later.
</Callout>

### 3. Create the Microsoft Teams connection

In Stacksync: **Connections** → **Create new connection** → **Microsoft Teams** → sign in with your Microsoft work account.

<Callout type="warn">
  The account used here must be able to grant **admin consent**

  The connection needs organization-level permissions (such as reading channel message history for context). If the consent screen says "Need admin approval," ask your Microsoft 365 administrator to create the connection or approve the app.
</Callout>

### 4. Attach the connection to your genie

Open your genie → **Interfaces** → **Add** → **Teams** → select the connection → **Save**.

### 5. Set access rights

If your Teams organization includes people without Stacksync accounts, set the genie's **Access rights** to **Public (authentication not required)** — otherwise only Stacksync workspace members get answers.

### 6. Talk to it

* **In a team channel:** type `@Genie` and **select it from the autocomplete popup**, then add your question. Typing the characters without selecting the suggestion sends plain text the bot never receives.
* **In a 1:1 chat:** just message it — no mention needed.

The genie posts the reasoning message and then finally the answer. Replies stay in the thread.

## Troubleshooting

| Symptom                                              | Check                                                                                                                                            |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Complete silence                                     | Is the Teams interface attached to a connection? Was the connection created by someone in the **same Teams organization** you're messaging from? |
| Generic answers that don't match your genie          | **Access rights** — your message was handled by the default assistant because you're not a recognized user. Set the genie to Public.             |
| `@Genie` doesn't appear in autocomplete in a channel | The app hasn't been **added to that team** — add it via Apps → Built for your org.                                                               |