Docs

Help desk / Automate

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).
  • Access review: asks reviewers to retain or revoke access for every user in a group (see 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:

StateWhat it means
DraftYou can edit it.
ScheduledIt waits for its launch time.
CreatingRisotto is building the recipient list, before it schedules or sends the campaign.
LiveRisotto has sent it, and recipients are responding.
CompletedEvery recipient has finished.
CanceledIt was canceled while it was live.
Creation failedThe 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).

Create a general campaign

  1. Start a new campaign

    On the Campaigns page, click 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.

  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.

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

  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.

  5. Add recipients

    Under Recipients, click Add recipient, Import, or Add group. See Recipients.

  6. Check the recipients

    Click Check recipients to find addresses that do not match a person in your Slack workspace. See Check recipients.

  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.

  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.

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 typeWhat 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).
CheckboxesChecks any of up to 10 choices.
Radio buttonsPicks one of up to 10 choices.
DatePicks a date.
TimePicks a time.
User pickerPicks a person in Slack.
Free textTypes 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.

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

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.

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

  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.

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