# Campaigns

Send a message, a form, or an access review to many people at once in Slack, and track who has responded

A campaign sends a message to many people at once, as a direct message from Risotto in Slack. Use it for announcements and reminders, for surveys and other structured questions, and for access reviews. Each recipient gets their own DM and responds on their own. You follow the whole group's progress on the campaign's page.

To create a campaign, your organization must have the Slack integration connected. Without it, **Create campaign** is disabled, and its tooltip points you to **Settings → Integrations**.

## Campaign types

When you create a campaign, you choose one of two types:

- **General**: a message to a list of recipients. You can attach an image and add seed reactions. To collect answers, add a form to the message (see [Form campaigns](#form-campaigns)).
- **Access review**: asks reviewers to retain or revoke access for every user in a group (see [Access review campaigns](#access-review-campaigns)).

## The Campaigns page

The **Campaigns** page lists your campaigns with their **Name**, **Type**, **State**, and **Launch date**. A scheduled campaign shows its launch time next to a calendar icon. Above the table, you can filter by name, **Type**, and **State**, and click **Clear** to remove the filters. **View** chooses the columns and the sort. The footer shows the number of campaigns, **Rows per page**, and the page.

In an access review where you are a reviewer, the **Task** column shows **Start**. Click it to open your review.

To open a campaign, click its name. The actions menu (⋮) at the end of each row has **Duplicate** and **Delete**, or **Cancel** for a live campaign.

A campaign is in one of these states:

| State               | What it means                                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Draft**           | You can edit it.                                                                                                                |
| **Scheduled**       | It waits for its launch time.                                                                                                   |
| **Creating**        | Risotto is building the recipient list, before it schedules or sends the campaign.                                              |
| **Live**            | Risotto has sent it, and recipients are responding.                                                                             |
| **Completed**       | Every recipient has finished.                                                                                                   |
| **Canceled**        | It was canceled while it was live.                                                                                              |
| **Creation failed** | The launch failed. The campaign's page lists the errors under **Launch Errors**. You can edit the campaign and launch it again. |

The **State** filter names some states differently: **Launching** for Creating, **Complete**, **Cancelled**, and **Failed** for Creation failed.

Next to the state, a warning icon means that some recipients could not be reached, and a clock icon means that a live campaign is past its due date.

## User permissions

Campaign access depends on your organization role:

- **Org Admins and Managers** can create, launch, duplicate, delete, and cancel campaigns, and send reminders.
- **Members** can view campaigns and their responses, export responses as CSV, edit a draft campaign, unschedule a scheduled campaign, and complete the campaign tasks assigned to them. They cannot create, launch, duplicate, delete, or cancel a campaign, or send reminders.
- Department roles (**Supervisor**, **Agent**) do not change campaign access. Only the organization role does. To let a Member create campaigns, an Org Admin changes their role to **Manager** (see [Invite users](https://www.tryrisotto.com/docs/guides/invite-users)).

> **Note:** Every recipient can answer a form or complete an access review, whatever their
> role.

## Create a general campaign

1. **Start a new campaign**

   On the **Campaigns** page, click **Create campaign**.

   *Product example: The Risotto Campaigns list, with filters for name, type and state, six campaigns, and Create campaign.*

2. **Name the campaign**

   Enter a **Name**, choose **General**, and click **Create**. Risotto opens the new draft.

   Recipients see the name in bold at the top of the message. To rename the draft later, click its title.

   *Product example: The Create Campaign dialog, with the name Laptop refresh survey, General chosen, and Create.*

3. **Write the message**

   In **Message**, write what recipients read. A new campaign starts with an example message, and **Reset to default** brings it back. See [Message content](#message-content).

   Risotto saves each change as you make it, and the header shows "All changes saved." To see the message as recipients will, click **Preview**.

   *Product example: A draft campaign's page: its message with @mention and first name variables, two seed reactions, and Attach image.*

4. **Add a form (optional)**

   To collect answers, click **Add your first field** under **Form (optional)**, and set up the question. Click **Add field** for each next question. See [Form campaigns](#form-campaigns).

   *Product example: A draft campaign's Form section, with a dropdown and a free-text question, and Add field.*

5. **Add recipients**

   Under **Recipients**, click **Add recipient**, **Import**, or **Add group**. See [Recipients](#recipients).

6. **Check the recipients**

   Click **Check recipients** to find addresses that do not match a person in your Slack workspace. See [Check recipients](#check-recipients).

   *Product example: A draft campaign's recipients after Check recipients: an Okta group not checked and one address marked Possible mismatch.*

7. **Schedule the launch (optional)**

   To send the campaign later, or on a repeating schedule, click **Schedule Launch** in the side panel and set **Launch at**. See [Scheduling and recurrence](#scheduling-and-recurrence).

8. **Launch the campaign**

   Click **Launch...** in the header. The **Launch campaign?** dialog shows the message that Risotto will send. Click **Launch**, or **Schedule** if you set a launch time.

   *Product example: A draft campaign scheduled for Dec 7 that repeats every three months, with Launch... in the header.*

After you launch it, you can no longer edit the campaign, but you can still cancel or delete it.

## Recipients

You can build a recipient list with any combination of:

- **Individual users.** Click **Add recipient** and search by name or email. The search returns at most 10 people at a time, and only people for whom Risotto has a Slack identity and an email. If you can't find someone, type their full email and choose **Add** with that address.
- **IdP groups.** Click **Add group** and choose a group in the **Select Group** dialog. It lists the groups of your connected Okta and Google Workspace. Risotto looks up the group's members when the campaign launches. A campaign can have only groups as recipients.
- **A CSV file.** Click **Import**, and drop a CSV file with one email address per line. Check the list of addresses, and click **Import**. Risotto keeps the recipients already in the list and skips addresses that are already there. This is the fastest way to add a long list.

While the campaign is a draft, the recipients show in a table, and Risotto saves each change:

- To fix an address, click it and edit it.
- To remove one recipient, click the trash icon on its row.
- To remove many recipients, select their rows. Use the header checkbox to select all rows, or hold **Shift** and click to select a range. Click **Delete N**, then click **Delete** to confirm. **Clear selection** removes the selection.

After you schedule the campaign, the table is read-only.

### Check recipients

To find addresses that do not match a person in your Slack workspace, click **Check recipients** above the table. Risotto compares each individual and imported address with the members of your Slack workspace. It does not change the list.

- A row that does not match shows **Possible mismatch**. Guests and people from other organizations show it too, but the launch can still reach them.
- An IdP group shows **Not checked**. Risotto looks up its members in Slack at launch.
- A dialog lists the possible mismatches. Click **Delete N** to remove them, or **Keep** to leave the list as it is. If every address matches, Risotto shows "No possible mismatches".

The check needs a connected Slack app. A large Slack workspace can take a few minutes to check.

## Message content

A general campaign's message is written in a rich text editor with the formatting Slack supports: bold, italic, strikethrough, code, links, bulleted and numbered lists, and quotes. To add an emoji, click the emoji button, or type `:` and the emoji's name.

Messages also support:

- **Template variables.** Type `{{mention}}` to @-mention the recipient, or `{{first_name}}` for their first name. They show as pills in the editor, and Risotto fills them in for each recipient. The example message uses both.
- **Line breaks**, which recipients see as you wrote them.
- **The campaign name as the title.** Each message starts with the campaign name in bold, above the message, with or without a form. Don't repeat the name as a heading in the message.
- **An image.** Under **Image (optional)**, click **Attach image** and choose a JPEG, PNG, GIF, or WebP file of up to 5 MB. The image shows under the message. To take it off, click **Remove**.
- **Seed reactions.** Pick up to four emoji in **Seed reactions (optional)**. Risotto adds them to each recipient's message, so recipients can react in one click. On the campaign's page, a recipient's reactions show under **Reacted with**. A reaction does not start anything: no ticket, automation, or runbook reads it. A recipient who needs help can send Risotto a message, which opens a ticket.

An access review's message is plain text. Risotto includes it in the review request that it sends each reviewer.

## Form campaigns

To turn a general campaign into a form, add questions under **Form (optional)**. Risotto sends each recipient the message with the form under it, in Slack. To send just the message, leave the form empty.

Each question is one of these field types:

| Field type                  | What the recipient does                                    |
| --------------------------- | ---------------------------------------------------------- |
| **Dropdown (single)**       | Picks one choice from a list (up to 100 choices).          |
| **Dropdown (multi-select)** | Picks several choices from a list (up to 100 choices).     |
| **Checkboxes**              | Checks any of up to 10 choices.                            |
| **Radio buttons**           | Picks one of up to 10 choices.                             |
| **Date**                    | Picks a date.                                              |
| **Time**                    | Picks a time.                                              |
| **User picker**             | Picks a person in Slack.                                   |
| **Free text**               | Types an answer. Turn on **Long answer** for a larger box. |

A form has at most 20 fields. Each field is **Required** unless you turn the switch off, and can have help text, which shows under the field. A choice has a label, which recipients see, and a value, which the answers record. Labels and values are at most 75 characters.

Recipients fill out the form in Slack and click **Submit**. The message then shows their answers, marked submitted, and they can't edit or send the form again.

*Product example: Risotto's campaign message in Slack: the campaign name, the message, a two-question form with Submit, and two seed reactions.*

> **Note:** This is a fixed set of Slack field types, not a form builder with conditions
> or branching, and not a web form. Recipients fill it out inside Slack.

### Building a form

In the form editor, add fields one at a time and arrange them in the order recipients should see them:

- **Drag to reorder.** Grab a field by its grip handle and drag it into place. A line shows where it will land.
- **Move up and Move down.** Move a field one place at a time with the up and down arrows.
- **Remove field.** Click the trash icon on the field.

## Access review campaigns

An access review asks reviewers to retain or revoke access for every user in a group. To set one up, create a campaign of the **Access review** type. Under **Groups to review**:

1. Click **Add apps** to add the groups of an application, or **Add groups** to choose from **Identity provider groups** and **Manual reviews**.
2. In each group's **Reviewer** field, enter the reviewer's email.

Under **Due by** in the side panel, you can set the date by which reviewers must finish. A scheduled access review sets **Days due after launch** instead (0 means no due date).

Each reviewer gets a DM with a temporary link to their review. If the link has expired, the reviewer clicks **Refresh link** for a new one. A reviewer can also click **Start** in the **Task** column of the Campaigns page.

When reviewers finish, the campaign's page shows **Access review results**: for each reviewer and group, each user shows **Access retained**, or **Access revoked on** and the date. If Risotto could not complete a revoke, the user shows **Access retained** with a reason in red, for example "Unable to check group membership" (your identity provider could not confirm whether the user is in the group) or "Unable to remove access. Okta did not remove the user from group ...".

## Scheduling and recurrence

You can launch a campaign right away or schedule it. Both general and access review campaigns can repeat.

To schedule a campaign, click **Schedule Launch** in the side panel, and set **Launch at** to a date and time. If the time has passed, the campaign launches as soon as you launch it. To repeat the campaign, describe the schedule in plain words in **Repeat**, for example "Every 3 months on the first Monday". The side panel shows the next launch after the first one. Each time a repeating campaign launches, Risotto schedules a copy of it for the next date. To remove the schedule, click the trash icon in the **Schedule** section.

To change a scheduled campaign, unschedule it back to a draft. You don't need to delete and rebuild it:

1. On the campaign's page, click **Unschedule to edit**.
2. Click **Unschedule** to confirm. The recipients stay. When you're done editing, launch or schedule the campaign again.

When you schedule or launch a campaign, Risotto first builds its recipient list. During this step, the campaign shows **Creating**. Risotto sends nothing during this step. The campaign then moves to scheduled or live. If the scheduled time passes while the campaign shows **Creating**, Risotto sends the campaign a few minutes after the step ends.

## Deleting or canceling a campaign

In the campaigns list, open the actions menu (⋮) on the campaign's row:

- **Delete** is available in every state except live, including while the campaign shows **Creating**. Confirm in the dialog. A campaign that you delete while it is being created stops before it is scheduled or launched, and sends nothing.
- **Cancel** replaces **Delete** for a live campaign. Risotto cancels the tasks that are still open and lets their recipients know.

To change a scheduled campaign instead of removing it, unschedule it back to a draft (see [Scheduling and recurrence](#scheduling-and-recurrence)).

## Launching a campaign

Until a campaign can launch, **Launch...** is disabled, and the campaign's page shows **Finish setup before launching** with what is missing. Hover **Launch...** to see the same list. For example:

- "Add at least one recipient before launching."
- "Every recipient needs an email address."
- "Add a message before launching." (a general campaign without a form)
- "Form field … is missing a label." or "Form field … needs at least one option."

The same rules are checked again when you launch, in case something changed after the page loaded.

> **Tip:** If you're not sure why **Launch...** is disabled, hover the button. The
> tooltip names what to fix.

If a deploy or backend restart interrupts a campaign while it's launching, Risotto detects the interruption and automatically resumes it within a few minutes. Recipients who were already notified before the interruption are never notified a second time.

## Duplicating a campaign

In the campaigns list, open the actions menu (⋮) on a campaign's row and click **Duplicate**. Risotto opens a new draft named after the original, with "(Copy)" added. The copy has the same message, recipients, form, image, and seed reactions. It has no launch time, due date, or repeat.

Use it to send a test campaign before the real one, or to repeat a campaign with small changes.

## Tracking responses

After you launch a general campaign, its page lists every recipient. At the top, a summary shows how much of the campaign is complete, how many recipients have responded (or, without a form, how many messages were delivered), and how many recipients are in each status, for example **5 submitted** and **3 awaiting response**. Recipients whose message could not be delivered are listed separately, with the reason. A campaign sent to IdP groups lists them under **Dynamic recipient groups**.

Each recipient's card shows their status, when they responded, and their answers. It also shows the emoji they reacted with, and **Reminded** if you sent them a reminder.

Use the controls above the list to find responses:

- **Search** by name or email.
- **Filter by status.** A form campaign offers **All statuses**, **Submitted**, **Awaiting response**, **Declined**, and **Canceled**. A campaign without a form offers **Sent**, **Pending**, **Declined**, and **Not delivered**. Each option shows its count. A status with no recipients is not listed.
- **Sort** by **Recently added** (the default), **Recently submitted**, **First submitted**, or **Name (A–Z)**. A campaign without a form says "sent" instead of "submitted". In the two response-time sorts, recipients who have not responded come last.

To see only the answers that are in, filter on **Submitted** and sort by **Recently submitted**. At the bottom of the list, set **Rows per page** to 10, 25, 50, or 100. If no recipient matches, click **Clear filters**.

You can also ask the [Assistant](https://www.tryrisotto.com/docs/dashboard/assistant) about a campaign, for example who has responded, what people said, or who still needs to answer. It reads the same responses as the CSV export. Org Admins and Managers can do this. The Assistant cannot read the results of an access review campaign.

Click **Export CSV** to download all responses. The export has every recipient and ignores the search, filter, and sort. It is separate from the recipient-list CSV that you may have imported to build the campaign.

To remind the recipients of a live form campaign who have not responded yet:

1. **Open the reminder**

   Click **Send reminder** above the recipients.

   *Product example: A live form campaign's recipients: 62% complete, Send reminder and Export CSV, and three recipient cards.*

2. **Send the reminder**

   Edit the message if you like, and click **Send reminder**.

The reminder can use `{{mention}}` and `{{first_name}}`, as the campaign message does. It threads under each recipient's original DM and does not start a new conversation. Each reminded recipient's card shows **Reminded**.

When every recipient has finished, the campaign moves to **Completed**, and Risotto sends the person who created it a DM in Slack to say so.

## Troubleshooting

### Create campaign is disabled

Campaigns are sent in Slack. Connect the Slack integration in **Settings → Integrations**.

### Can't find a recipient by name in the picker

The picker only finds people for whom Risotto has a Slack identity and an
email. Type the person's full email to add them directly, have them message
Risotto once so it records them, or import a CSV file for a long list.

### Launch button is disabled

Hover **Launch...** or check **Finish setup before launching** on the
campaign's page. It names what to fix: missing recipients, a recipient without
an email, an empty message, or an incomplete form field.

### A campaign seems stuck after a deploy

Campaigns interrupted mid-launch by a backend deploy or restart are
automatically detected and resumed within a few minutes, without re-notifying
recipients who already received a message. If a campaign is still stuck well
beyond that, reach out to your Risotto contact.

### Recipients are only IdP groups

This is supported. A campaign can launch with IdP groups as its only recipients, and Risotto looks up their members at launch.

Source: https://www.tryrisotto.com/docs/dashboard/campaigns
