# Microsoft Teams

Bring your Wonderchat AI chatbot directly into Microsoft Teams. Mention **@Wonderchat AI** in any standard or shared channel and get instant, AI-powered answers grounded in your own knowledge base — without leaving the conversation.

This guide walks you through everything you need: installing the app in Teams, connecting it to Wonderchat, linking a chatbot, and using it day-to-day.

{% hint style="info" %}
The Wonderchat AI app is currently **pending review** in the Microsoft Teams app store. Until that review completes, the only way to install it is via the **manual sideload** flow described in **Step 1 — Option B** below. Once approved, the standard app store install will become available.
{% endhint %}

***

## What you can do

* **Chat with your custom AI chatbot** inside any Teams channel by mentioning `@Wonderchat AI`.
* **Get answers grounded in your own data** — the bot only responds with information from the chatbot you've trained.
* **Collaborate as a team** — replies are visible in-channel so your whole team benefits from each answer.

## Before you start

You'll need three things:

1. A **Wonderchat account** with at least one chatbot trained and ready to go. Don't have one yet? Sign up at [wonderchat.io](https://wonderchat.io) and create your first chatbot at [app.wonderchat.io/agents](https://app.wonderchat.io/agents).
2. A **Microsoft Teams workspace** where you have permission to install apps. If you don't, your Teams admin can install it for you.
3. About **5 minutes** of your time.

{% hint style="warning" %}
The Wonderchat AI bot works in **standard** and **shared** channels only. Microsoft Teams doesn't currently allow bots in private channels.
{% endhint %}

***

## Step 1 — Install the Wonderchat AI app in Microsoft Teams

You have two ways to install the app, depending on whether your organization has approved it from the Teams app store.

### Option A — Install from the Teams app store (easiest)

{% hint style="info" %}
This option will become available once Microsoft completes its review of the Wonderchat AI app. For now, please use **Option B** below.
{% endhint %}

1. Open Microsoft Teams.
2. Click **Apps** in the left sidebar.
3. Search for **Wonderchat AI**.
4. Click **Add** and choose the team you want to install it into.

If you can't find the app in your store, your Teams admin may need to approve it first — see Option B.

### Option B — Sideload the app manifest (for admins / custom installs)

If your organization needs to upload the app manually:

1. Download the **Wonderchat AI Teams app package** from [app.wonderchat.io/wonderchat-teams-app.zip](https://app.wonderchat.io/wonderchat-teams-app.zip) (a ZIP file containing `manifest.json`, `color.png`, and `outline.png`).
2. Open Microsoft Teams.
3. Go to **Apps** → **Manage your apps** → **Upload an app**.
4. Choose **Upload a custom app** (or **Upload an app to your org's app catalog** if you're a Teams admin and want to make it available to your whole organization).
5. Select the ZIP file you downloaded.
6. Once uploaded, click **Add** and pick the team you want to install it into.

{% hint style="info" %}
**Tip for Teams admins:** Uploading via **Teams Admin Center → Manage apps → Upload new app** makes Wonderchat AI available to your entire org. Individual users can then install it from their app store without needing custom upload permissions.
{% endhint %}

You'll know it worked when you see **Wonderchat AI** appear in the team's app list.

***

## Step 2 — Connect Microsoft Teams to your Wonderchat account

Now you'll tell Wonderchat which team(s) you've installed the app into and which chatbot should answer in each one.

1. Sign in to your Wonderchat console at [app.wonderchat.io](https://app.wonderchat.io).
2. Open any chatbot, go to **Settings**, and find the **Microsoft Teams** integration. (You can also reach it from **Channels** in your **Chatbots** tab)
3. Click **Sign in with Microsoft** and approve the permission request. Wonderchat asks for `Team.ReadBasic.All` so it can list the teams you're a member of — that's it.
4. Under **Connected Teams**, add each team you want the bot to work in. Only teams where the Wonderchat AI app is installed will be eligible.
5. Under **Linked Chatbots**, choose which Wonderchat chatbot should respond in each connected team. One chatbot per team.

That's it — you're connected.

***

## Step 3 — Try it out

Hop into any standard or shared channel in your connected team and type:

```
@Wonderchat AI What's our refund policy?
```

The bot will reply with **"Thinking..."** and then update the message with an AI-generated answer drawn from your chatbot's training data. Long replies are split into multiple messages automatically.

### Slash-style commands

You can also use these built-in commands by mentioning the bot:

| Command                         | What it does                                                               |
| ------------------------------- | -------------------------------------------------------------------------- |
| `@Wonderchat AI help`           | Shows a quick reference for using the bot                                  |
| `@Wonderchat AI conn`           | Tells you which Wonderchat workspace and chatbot this team is connected to |
| `@Wonderchat AI ask [question]` | Same as just typing your question — the `ask` prefix is optional           |

***

## Managing the integration

### Switch the chatbot for a team

Go to **Settings → Microsoft Teams → Linked Chatbots** in the Wonderchat console and pick a different chatbot for that team.

### Disconnect a team

Remove it from **Connected Teams**. The Wonderchat AI app will stay installed in Teams, but it will stop responding until you reconnect it.

### Sign out of Microsoft

Click **Sign out** at the top of the Microsoft Teams settings card. This revokes Wonderchat's access to your Microsoft account and removes all of your connected teams.

### Uninstall the app from Teams

In Teams, go to the team's settings → **Apps** → find Wonderchat AI → **Uninstall**.

***

## Frequently asked questions

#### Does the bot read every message in the channel?

No. The bot only sees messages where it's explicitly mentioned (`@Wonderchat AI`). Messages without a mention are never sent to Wonderchat.

#### Can I use it in a private channel?

Not yet — Microsoft Teams doesn't currently support bots in private channels. Standard and shared channels work great.

#### Can multiple teams share one chatbot?

Yes. You can link the same chatbot to as many teams as you'd like. Each team's conversations are still tracked separately in your Wonderchat chatlogs.

#### Where do I see the conversations?

Every Teams thread shows up in your Wonderchat chatlogs under **Chatlogs** in the console, tagged with the source `MICROSOFT_TEAMS`. You can review, filter, and export them like any other chat.

#### The bot says "this team is not connected" — what now?

This usually means either (a) you haven't added the team under **Connected Teams** in the Wonderchat console yet, or (b) you've connected it but haven't linked a chatbot. Run `@Wonderchat AI conn` in the channel to see exactly what's missing, then head to the console to fix it.

#### The bot didn't reply — what should I check?

* Make sure you mentioned `@Wonderchat AI` (the bot ignores messages without a mention).
* Confirm you're in a **standard or shared channel**, not a private one or a 1:1 chat.
* Check that the team is connected and a chatbot is linked.
* Try `@Wonderchat AI conn` for a quick health check.

#### Is my data secure?

Yes. Messages are sent over Microsoft's authenticated bot channel and verified on our end before being passed to your chatbot. We only store the messages where the bot was mentioned, and only your own chatbot's training data is used to generate replies.

***

## Need a hand?

* **Manage your chatbots and connections:** [app.wonderchat.io/agents](https://app.wonderchat.io/agents)
* **Create a Wonderchat account:** [wonderchat.io](https://wonderchat.io)
* **Talk to a human:** [wonderchat.io/contact](https://wonderchat.io/contact)

Happy chatting!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wonderchat.io/integration-guides/microsoft-teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.