> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack Workflow Builder
> Connect a custom Slack app to Ravenna so your team can create tickets from Slack Workflow Builder using a no-code Open Form step.
Connect a custom Slack app to Ravenna so your team can open Ravenna request forms, and create tickets, directly from Slack Workflow Builder. The Workflow app adds an **Open Form** step that you can drop into any Slack workflow, so people submit requests without leaving Slack.
The Workflow app is separate from the main Ravenna Slack app. The main app is installed and owned by Ravenna. The Workflow app is a custom app that you create and own in your own Slack workspace, then register with Ravenna using its App ID and Signing Secret. Each connected Slack workspace can have one Workflow app.
Slack does not let third-party apps distribute workflow steps automatically, so you create the app yourself from a manifest Ravenna provides. This gives you a Workflow app that is already configured to talk to Ravenna. You only need to set the name and icon.
## Prerequisites
You must be a **Slack workspace admin** to create and install a custom Slack app. If you don't have admin permissions, ask your Slack administrator to complete these steps.
Before you start, connect your Slack workspace to Ravenna if you haven't already.
Follow the [Slack setup guide](/integrations/slack/setup) to connect your workspace first.
## Create the Slack app from a manifest
1. Go to the [Slack apps page](https://api.slack.com/apps) and click **Create New App**.
2. In the **Create an app** dialog, select **From a manifest**.
Choose the Slack workspace where you want to install the Workflow app.
Copy the manifest below and paste it into the JSON editor.
```json theme={"system"}
{
"display_information": {
"name": "Ravenna Workflows",
"description": "Workflow app for Ravenna",
"background_color": "#000000"
},
"features": {
"bot_user": {
"display_name": "Ravenna Workflows",
"always_online": false
}
},
"functions": {
"ravenna_open_form": {
"title": "Open Form",
"description": "Opens a Ravenna form as a Slack modal so the person can submit a request. Setup guide: https://docs.ravenna.ai/integrations/slack/workflow-builder",
"input_parameters": {
"formId": {
"type": "string",
"title": "Form ID",
"description": "The ID of the Ravenna form to open.",
"hint": "Find the ID in the request type URL in Ravenna. Required.",
"is_required": true
},
"channelId": {
"type": "slack#/types/channel_id",
"title": "Slack channel",
"description": "The Slack channel where the workflow runs. Used to route the ticket to the matching Ravenna channel.",
"hint": "Select 'Channel where the workflow was used' to route the ticket to the matching Ravenna channel.",
"is_required": false
},
"queueId": {
"type": "string",
"title": "Ravenna channel",
"description": "Fallback Ravenna channel to route the ticket to when the workflow runs outside a connected Slack channel.",
"hint": "Fallback used when the workflow runs outside a connected Slack channel, such as from a direct message.",
"is_required": false
},
"interactivity": {
"type": "slack#/types/interactivity",
"title": "Interactivity",
"description": "Interactivity context required to open a modal.",
"hint": "Leave this set to the provided interactivity context.",
"is_required": true
}
},
"output_parameters": {}
}
},
"oauth_config": {
"redirect_urls": ["https://core.api.ravennahq.com/api/oauth/slack"],
"scopes": {
"bot": ["chat:write", "files:read", "users:read", "users:read.email"]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://core.api.ravennahq.com/api/slack/events",
"bot_events": ["function_executed"]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://core.api.ravennahq.com/api/slack/interactions"
},
"org_deploy_enabled": true,
"socket_mode_enabled": false,
"token_rotation_enabled": false,
"function_runtime": "remote"
}
}
```
Review the configuration and click **Create**. Your Workflow app is now configured and ready to use.
On the app's **Basic Information** page, set a display name and icon that match your team's branding. The step name shown in Workflow Builder comes from the manifest, so renaming the app does not change it.
In the left sidebar, go to **Install App** and click **Install to Workspace**. Review the requested permissions and click **Allow**.
## Connect the Workflow app to Ravenna
After you create the app, register it with Ravenna so Ravenna can verify and process requests from it.
On the Slack app's **Basic Information** page, copy the **App ID** and the **Signing Secret**.
If your forms include file uploads, also copy the **Bot User OAuth Token** (starts with `xoxb-`) from the app's **OAuth & Permissions** page. Ravenna uses it to download files that people attach in the form. You can skip this if your forms have no file fields.
In Ravenna, go to **Settings > Integrations** and find the **Workflow App** tile for the workspace you want to connect. Click **Connect**.
Paste the **App ID**, **Signing Secret**, and (if needed) the **Bot User OAuth Token**, then save.
File uploads in forms only work when you provide the Bot User OAuth Token. Without it, the ticket is still created but attached files are dropped, because only the Workflow app's own token can download files uploaded through its modal.
1. The App ID and Signing Secret must both come from the same Slack app you created from the manifest. If they don't match, Ravenna cannot verify requests and the workflow step does nothing.
2. If you have more than one Slack workspace connected to Ravenna, connect the credentials to the **Workflow App** tile for the same workspace where you installed the app.
## Build a workflow that creates tickets
New to Slack Workflow Builder? See [Slack's Workflow Builder guide](https://slack.com/help/articles/360035692513-Guide-to-Slack-Workflow-Builder) to get started.
In Slack, click **Tools** in the sidebar and select **Workflows**. You can also press ⌘+K / Ctrl+K and search for "Workflows".
Click **New Workflow**, then choose the **From a link in Slack** trigger. This creates a link and button that people click to start the workflow.
Click **Add Steps**, search for the name of the custom app you installed, and add the **Open Form** step.
The Open Form step has the following inputs:
* **Form ID** (required): The Ravenna form to open.
In Ravenna, go to **Forms** and open the form you want to use. The Form ID is the last part of the page URL:
```text theme={"system"}
https://app.ravenna.ai//forms/
```
Copy the `` value and paste it into the step.
* **Slack channel**: Click the channel dropdown and select **Channel where the workflow was used**. This passes the Slack channel to Ravenna so it can route the ticket to the matching Ravenna channel.
* **Ravenna channel**: A fallback Ravenna channel to use when the workflow runs outside a connected Slack channel, such as from a direct message.
In the Ravenna sidebar, hover over the channel you want to use and open its actions menu (the **...** icon). Click **Copy** to copy the channel ID to your clipboard, then paste it into the step.
Click **Finish Up** to save, then publish the workflow. Your team can now run it to open the form and create a ticket.
## Make the workflow discoverable
Help your team find and use the workflow with either of these options.
Feature the workflow so it appears in a channel's Workflows tab. See [Slack's guide to featuring a workflow](https://slack.com/help/articles/32393999092883-Manage-the-Workflows-tab-in-channels-and-DMs#feature-a-workflow).
Add the workflow to a Slack Canvas for a more visual, organized entry point. See [Slack's guide to sharing a Canvas](https://slack.com/help/articles/360056199714-Share-a-Canvas-in-a-channel-or-DM).
## Troubleshooting
**Cause**: Ravenna cannot verify the request, or the app was not built from the Ravenna manifest.
**Solution**:
* Confirm the **App ID** and **Signing Secret** in Ravenna match the Slack app you created from the manifest.
* Confirm you created the app from the manifest above, which includes the `ravenna_open_form` function.
* Confirm the **Form ID** in the step points to a valid Ravenna form.
**Cause**: Ravenna could not resolve the destination from the Slack channel.
**Solution**:
* Set the **Slack channel** input to **Channel where the workflow was used** so Ravenna receives the channel at run time.
* Set a **Ravenna channel** as a fallback for workflows that run outside a connected Slack channel.
Learn more about [creating tickets in Slack](/integrations/slack/creating-tickets) and using [Slack triggers and actions in Ravenna workflows](/integrations/slack/workflows).