# Communication Best Practice

Announcement templates for rolling out Risotto in Slack or Microsoft Teams, and how to match them to your channel settings

When you roll out Risotto, tell employees where to ask for help, how to ask, and how to reach a person. Copy a template below, fill in the parts in brackets, and post it where employees already look for help.

## Before you announce

- **Match the template to the channel's settings.** A Slack channel you add to Risotto starts with **Silent mode** on, and a Microsoft Teams channel starts with **Silent channel** on. In a silent channel, Risotto answers only a message that mentions it. Turn the setting off if you want Risotto to answer every post, or tell employees to mention Risotto. See the settings for [Slack channels](https://www.tryrisotto.com/docs/dashboard/settings/request-sources#channel-settings) and [Microsoft Teams channels](https://www.tryrisotto.com/docs/dashboard/settings/request-sources#microsoft-teams-channels).
- **Use your bot's name.** If you installed a [custom Slack app](https://www.tryrisotto.com/docs/guides/initial/slack-app-custom), replace "Risotto" with its name.
- **Pin the announcement** in the help channel, so that new employees find it.

## Slack

### Existing help channel

Post this in the channel where employees already ask for help, once Risotto is in it.

> 🚀 **Meet @Risotto, our new AI help desk assistant** 🚀
>
> Starting today, @Risotto answers requests in this channel. It answers from our \[IT] documentation and can take care of common requests, such as \[software access and password resets]. When it can't help, it brings in our team.
>
> ❓ **FAQs**
>
> - **How do I ask for help?** Post your request here, as you do today. Risotto replies in the thread. \[In a silent channel: Mention @Risotto in your message.]
> - **How do I follow up?** Reply in the same thread. Start a new post for a new request.
> - **What if I want to talk to a person?** Ask for one in the thread, and Risotto brings in our team.
> - **How do I know the answer is right?** When Risotto answers from our documentation, it links the page it used, so you can read the source.
> - **Can I ask privately?** Yes. Send @Risotto a direct message.

This is what employees see when they post a request:

*Product example: A Slack thread in #risotto-requests-test, in outline: Priya asks for help with a laptop that won't charge, and Risotto replies after creating ticket IT-142.*

### Company-wide announcement

Post this in a company-wide channel or send it by email.

> 👋 **Need help from \[IT]? Ask @Risotto.**
>
> @Risotto is our AI help desk assistant. It answers from our \[IT] documentation and can take care of common requests, such as \[software access and password resets]. When it can't help, it brings in our team.
>
> **Ways to ask:**
>
> - Post in \[#help-it]. \[In a silent channel: Mention @Risotto in your message.]
> - Send @Risotto a direct message.
> - Open the Risotto app in Slack, go to its **Home** tab, and click **Start a new request**.
>
> To talk to a person, ask Risotto for one in your conversation.

The **Start a new request** button shows only when you add departments to the **App Home** card. See [Start a request from the App Home](https://www.tryrisotto.com/docs/operating/creating-tickets#start-a-request-from-the-app-home). Remove that line if you don't use it.

For how each of these ways creates a ticket, see [Creating tickets from Slack](https://www.tryrisotto.com/docs/operating/creating-tickets).

## Microsoft Teams

### Help channel

Post this in the Teams channel you added as a request source.

> 🚀 **Meet Risotto, our new AI help desk assistant** 🚀
>
> Starting today, Risotto answers requests in this channel. It answers from our \[IT] documentation and can take care of common requests, such as \[software access and password resets]. When it can't help, it brings in our team.
>
> ❓ **FAQs**
>
> - **How do I ask for help?** Start a new post in this channel and @mention Risotto. Risotto replies in the post's thread. \[If Silent channel is off: Start a new post. You don't need to mention Risotto.]
> - **How do I follow up?** Reply in the same thread. Start a new post for a new request.
> - **What if I want to talk to a person?** Ask for one in the thread, and Risotto brings in our team.
> - **Can I ask privately?** Yes. Open a chat with Risotto in Teams and send it a message.

This is what employees see when they post a request:

*Product example: A post 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.*

### Company-wide announcement

Post this in a company-wide channel or send it by email.

> 👋 **Need help from \[IT]? Ask Risotto.**
>
> Risotto is our AI help desk assistant in Microsoft Teams. It answers from our \[IT] documentation and can take care of common requests, such as \[software access and password resets]. When it can't help, it brings in our team.
>
> **Ways to ask:**
>
> - Open a chat with Risotto in Teams and send it a message. You can keep several requests going in the same chat.
> - Post in the \[Ask IT] channel and @mention Risotto.
>
> To talk to a person, ask Risotto for one in your conversation.

Employees can chat with Risotto once the app is available to them. See [Microsoft Teams app setup](https://www.tryrisotto.com/docs/guides/teams/teams-app).

For how Teams posts and chats create tickets, see [Creating tickets from Microsoft Teams](https://www.tryrisotto.com/docs/operating/creating-tickets-teams).

Source: https://www.tryrisotto.com/docs/guides/rollout/communications
