# Microsoft Teams Channel Setup

Add Risotto to a team in Microsoft Teams, add the team's channels as request sources, and choose when Risotto answers

To take requests in a Teams channel, add Risotto to the channel's team in Microsoft Teams, then add the channel as a request source in Risotto. Before you start, connect Teams and make the app available. See [Microsoft Teams App Setup](https://www.tryrisotto.com/docs/guides/teams/teams-app).

To watch the whole setup, from sign-up to the first ticket, see the [setup video](https://www.tryrisotto.com/docs/guides/teams/teams-setup-video).

Direct messages to Risotto need no setup. See [Creating Tickets from Microsoft Teams](https://www.tryrisotto.com/docs/operating/creating-tickets-teams#direct-messages).

## Add Risotto to a team

1. **Find Risotto in Teams**

   In Microsoft Teams, select **Apps**, search for **Risotto**, and select it.

2. **Choose Add to a team**

   Open the menu next to **Add** (or **Open**, if you already added Risotto for
   yourself) and choose **Add to a team**.

3. **Pick the team**

   Type or select the team that has the channel you want, then select **Set
   up a bot**.

   *Product example: Microsoft Teams' dialog for adding Risotto to a team, drawn in outline, with the IT Help team and Set up a bot.*

   Risotto posts a welcome message in the team's **General** channel.

> **Note:** Your organization can limit who adds apps to a team. If you can't add Risotto,
> ask an owner of the team.

## Add the channel in Risotto

1. **Open the Teams Requests tab**

   In the Risotto dashboard, go to **Settings > Request Sources** and click
   **Manage in Microsoft Teams**.

   *Product example: Settings, Request Sources in the Risotto dashboard, with the Microsoft Teams card, no channels yet, and Manage in Microsoft Teams.*

2. **Click Add Channel**

   On the **Microsoft Teams channels** card, click **Add Channel**.

3. **Pick the team and channel**

   Pick a **Team**, then a **Channel**, and click **Add Channel**. The
   **Team** list shows the teams Risotto has been added to. The channel is
   added with **Silent channel** on.

   *Product example: The Add Channel dialog over Microsoft Teams' Requests tab in the Risotto dashboard, with the IT Help team and Ask IT channel picked, and Add Channel.*

   If the **Team** list reads "No teams found yet", add Risotto to the team first. If you added Risotto to the team before connecting Teams in Risotto, post a message in one of the team's channels, then try again.

4. **Choose when Risotto answers**

   Open the channel's row and set **Silent channel**:

   - **On**: Risotto answers only posts that @mention it.
   - **Off**: every new post in the channel opens a ticket, and Risotto answers it.

   To send every request from the channel to one department, set **Lock to department**.

   *Product example: Microsoft Teams' Requests tab in the Risotto dashboard with the Ask IT channel open, with its Silent channel switch.*

A channel can also join the list without **Add Channel**: the first time someone @mentions Risotto in it, or when someone creates a new channel in a team Risotto is in. It starts with **Silent channel** on. See [Request Sources](https://www.tryrisotto.com/docs/dashboard/settings/request-sources#microsoft-teams-channels) for each channel's settings.

## Test your setup

1. **Post a request**

   In the channel, post a request that @mentions Risotto. This works whether
   **Silent channel** is on or off.

2. **Watch Risotto reply**

   Risotto adds 👀 to your post while it reads it. Then it replies in the
   post's thread with the ticket's ID and title, such as `[IT-142] Laptop
       Wi-Fi Connection Issue`, shows a "⏳ Thinking…" card while it works, and
   replaces the card with its answer.

   *Product example: Priya's post mentioning Risotto in the Ask IT channel in Microsoft Teams, drawn in outline, and Risotto's replies in its thread: the ticket ID and title, then its answer.*

3. **Find the ticket**

   In the Risotto dashboard, find the ticket in the [Ticket
   inbox](https://www.tryrisotto.com/docs/dashboard/tickets/all).

## Next steps

Once Microsoft Teams is set up and tested:

1. Complete your [organization setup](https://www.tryrisotto.com/docs/guides/initial/org-setup)
2. Read how Risotto handles channel posts and direct messages in [Creating Tickets from Microsoft Teams](https://www.tryrisotto.com/docs/operating/creating-tickets-teams)
3. Configure additional settings as needed for your organization

Source: https://www.tryrisotto.com/docs/guides/teams/teams-helpdesk
