# Send Slack Form

Sends an interactive Slack form mid-conversation to collect structured responses and post them to the ticket

Sends an interactive form to the requestor in Slack, built from the same field types available in [Campaign forms](https://www.tryrisotto.com/docs/dashboard/campaigns#form-campaigns). Use it inside a runbook to collect structured information mid-conversation instead of asking free-form questions.

> **Note:** Runbooks can also collect structured input with [Runbook
> Forms](https://www.tryrisotto.com/docs/dashboard/runbooks/forms), org-level forms that are reusable across
> runbooks, render in Slack **and** Microsoft Teams, fall back to conversational
> collection on other channels, and don't count toward the tool limit. Use this
> Slack tool when you specifically need Slack-only field types such as user
> pickers, checkboxes, or radio buttons.

## Authentication

This tool posts from your main Risotto Slack app — the same app that handles the ticket conversation — so it needs no separate credentials, token, or connector setup. Unlike other Slack tools, there's no per-tool token override: the form always goes out in the ticket thread from your Risotto agent.

> **Warning:** **If you run a custom Risotto Slack app, check that its manifest is current
> before enabling this tool.** Interactive forms shipped more recently than most
> features — a custom app created from an older manifest may be missing what
> forms need to render and submit, and the tool will fail when it runs. Update
> your app to the latest manifest by following the [Update Slack
> App](https://www.tryrisotto.com/docs/guides/update-slack-app) guide. No other changes (API keys, webhooks, or
> reinstalls beyond that guide's manifest update flow) are required.
> Marketplace-app organizations don't need to do anything — the marketplace app
> is kept current automatically.

## How It Works

1. Configure a form as a tool: define the title, intro text, and fields (see [Configuration](#configuration) below).
2. Add the tool to a runbook.
3. When the runbook reaches that step, the agent sends the form to the requestor in the ticket thread.
4. The requestor fills it out in Slack. Interacting with individual fields while the form is in progress doesn't trigger a response from the agent — only submitting the form does.
5. Once submitted, the form locks (it can't be resubmitted or edited) and the responses are posted back into the ticket for the agent to continue from.

## Configuration

The form is defined on the tool itself. Find it in the tool catalog under [**Tools**](https://dashboard.tryrisotto.com/tools) — it appears there as **Send Form to Ticket Requestor in Slack**. Each tool instance defines one form, so create a separate tool for each distinct form your runbooks should send.

### Title and Intro Text

- **Title** — the heading shown above the form in Slack. If left blank, the tool's name is used as the title, so give the tool a requestor-friendly name if you skip this field.
- **Intro Text**: an optional sentence shown under the title. Use it to set context for the requestor, e.g. "We need a few details to process your hardware request."

### Fields

Every form needs at least one field. Fields are added one at a time in the form editor and can be reordered before publishing the tool. Each field is configured with:

- **Label** (required) — the question or prompt shown above the input
- **Field type** (required) — see the table below
- **Options**: for choice fields (**Dropdown (single)**, **Dropdown (multi-select)**, **Checkboxes**, **Radio buttons**): the list of choices the requestor picks from, each with a display label and a stored value. A choice field needs at least one option.
- **Required** — fields are **required by default**; the requestor can't submit the form until every required field is filled. Toggle this off to make a field optional.
- **Help text** — optional guidance rendered under the field
- **Long answer**: free-text fields only: switches the input from a single line to a paragraph box

| Field type              | What the requestor sees                                                      |
| ----------------------- | ---------------------------------------------------------------------------- |
| Dropdown (single)       | Dropdown, single choice                                                      |
| Dropdown (multi-select) | Dropdown, multiple choices                                                   |
| Checkboxes              | One or more checkbox options                                                 |
| Radio buttons           | Single choice from visible options                                           |
| Date                    | Date picker                                                                  |
| Time                    | Time picker                                                                  |
| User picker             | Slack user selector                                                          |
| Free text               | Open text response (single line, or a paragraph box with **Long answer** on) |

> **Note:** This is Block Kit forms with a fixed set of field types — not an arbitrary
> conditional or branching form builder. Recipients fill it out inside Slack,
> not on a web page. Campaign forms use the same field types and editor — see
> [Campaign Forms](https://www.tryrisotto.com/docs/dashboard/campaigns#form-campaigns).

## Limitations

> **Warning:** This tool only works for tickets sourced from Slack. It won't fire for tickets
> that came in through Jira, email, or other non-Slack request sources. If a
> runbook could match tickets from multiple sources, add a condition to skip
> this tool for non-Slack tickets.

## Troubleshooting

### Form fails to send or submit

If your organization runs a custom Risotto Slack app, its manifest may predate
interactive forms. Update the app to the latest manifest by following the
[Update Slack App](https://www.tryrisotto.com/docs/guides/update-slack-app) guide, then try again.

## Related

- [Runbook Forms](https://www.tryrisotto.com/docs/dashboard/runbooks/forms) — org-level, reusable structured-input forms that work in Slack, Teams, and conversationally
- [Slack Tools Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup)
- [Campaign Forms](https://www.tryrisotto.com/docs/dashboard/campaigns#form-campaigns) — the same underlying form-building system, used to broadcast a form to many recipients at once instead of mid-conversation in a single ticket

Source: https://www.tryrisotto.com/docs/integrations/tools/slack/send_form
