# Microsoft Teams App Setup

Connect Risotto to your Microsoft 365 organization with admin consent, then make the Risotto app available to everyone in the Teams admin center

Connect Risotto to your Microsoft 365 organization, then make the Risotto app available in Microsoft Teams. The Risotto app is published in the Microsoft Teams Store, so there is no app to build or upload.

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

> **Note:** **Before you begin**, make sure you have:
>
> - The **Org Admin** role in Risotto. See [Permissions](https://www.tryrisotto.com/docs/operating/permissions).
> - A Microsoft account that can grant admin consent for your organization, such as a Global Administrator or Privileged Role Administrator.
> - Access to the [Teams admin center](https://admin.teams.microsoft.com), for example as a Teams Administrator.

## Connect Microsoft Teams in Risotto

1. **Open Integrations**

   In the Risotto dashboard, go to **Settings > Integrations**.

2. **Open Microsoft Teams**

   Click the **Microsoft Teams** card. It's in the **Request sources** group,
   or type "Teams" in **Search integrations**.

   *Product example: Settings, Integrations in the Risotto dashboard, with the Microsoft Teams card under Request sources.*

3. **Click Connect**

   On the **Chat app** card ("Connect Risotto to your Microsoft Teams
   workspace."), click **Connect**. Microsoft's admin consent page opens.

   *Product example: Microsoft Teams's page in the Risotto dashboard, with Connect on the Chat app card.*

4. **Sign in to Microsoft**

   Sign in with the Microsoft account that can grant admin consent.

5. **Accept the permissions**

   Review the permissions Risotto requests for your organization, and click
   **Accept**.

   *Product example: Microsoft's admin consent page for Risotto, drawn in outline, with Permissions requested and Accept.*

   You return to the Microsoft Teams page in the Risotto dashboard. The page and the **Chat app** card show **Connected**, with your organization's **Tenant ID**. Once Risotto is added to a team, the card also lists **Installed teams**.

   *Product example: Microsoft Teams's page in the Risotto dashboard after consent: Connected, with the tenant ID.*

> **Note:** Risotto connects to one chat platform at a time. If Slack is connected, the
> **Chat app** card reads "Slack is already connected. Only one chat integration
> can be active at a time." and **Connect** is unavailable.

If you take more than 5 minutes on Microsoft's pages, the link expires and you see "State not found or expired, please go back and try again." Go back to the Microsoft Teams page and click **Connect** again.

## Make the app available to everyone

1. **Open Manage apps**

   Sign in to the [Teams admin center](https://admin.teams.microsoft.com) and
   go to **Teams apps > Manage apps**.

2. **Open Risotto's page**

   Search for **Risotto** and select its name. The publisher is **Risotto
   AI**.

   *Product example: The Teams admin center's Manage apps, drawn in outline, searched for Risotto, with its name.*

3. **Edit its availability**

   On the **Users and groups** tab, select **Availability**, then **Edit
   availability**.

4. **Make it available to everyone**

   Under **Available to**, select **Everyone**, then click **Apply**.

   *Product example: Risotto's Users and groups tab in the Teams admin center, drawn in outline, with the Edit availability pane's Available to menu open and Everyone.*

Microsoft says availability changes can take up to 24 hours to reach everyone in your organization. If people can't find Risotto in Teams yet, wait and try again. See Microsoft's [app centric management](https://learn.microsoft.com/en-us/microsoftteams/app-centric-management) guide for availability to specific users or groups.

> **Tip:** Making the app available lets people add Risotto themselves. To add it to
> everyone's Teams for them, use an [app setup
> policy](https://learn.microsoft.com/en-us/microsoftteams/teams-app-setup-policies).
> When the app is installed for someone, Risotto sends them a one-time welcome
> message, and they can message Risotto directly to open a request. See
> [Creating Tickets from Microsoft
> Teams](https://www.tryrisotto.com/docs/operating/creating-tickets-teams#direct-messages).

## Next steps

Continue to [Microsoft Teams Channel Setup](https://www.tryrisotto.com/docs/guides/teams/teams-helpdesk) to add Risotto to a team and choose the channels where it takes requests.

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