Docs

Get started / Install in Microsoft Teams

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.

To watch the whole setup, from sign-up to the first ticket, see the setup video.

Direct messages to Risotto need no setup. See Creating Tickets from Microsoft Teams.

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.

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

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.

  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.

    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.

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 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.

  3. Find the ticket

    In the Risotto dashboard, find the ticket in the Ticket inbox.

Next steps

Once Microsoft Teams is set up and tested:

  1. Complete your organization setup
  2. Read how Risotto handles channel posts and direct messages in Creating Tickets from Microsoft Teams
  3. Configure additional settings as needed for your organization

Something wrong or missing? Report an issue Ā· View as Markdown