Skip to main content
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 to connect your workspace first.

​
Create the Slack app from a manifest

1

Create a new app

  1. Go to the Slack apps page and click Create New App.
  2. In the Create an app dialog, select From a manifest.
Create an app dialog with the From a manifest option selected
2

Select your workspace

Choose the Slack workspace where you want to install the Workflow app.
Slack workspace picker for the new app
3

Paste the manifest

Copy the manifest below and paste it into the JSON editor.
{
  "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"]
    }
  },
  "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"
  }
}
4

Review and create

Review the configuration and click Create. Your Workflow app is now configured and ready to use.
5

Set the name and icon

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.
Update app name, icon and color.
6

Install the app to your workspace

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

Copy the credentials

On the Slack app’s Basic Information page, copy the App ID and the Signing Secret.
Slack Basic Information page showing the App ID and Signing Secret
2

Open Ravenna integration settings

In Ravenna, go to Settings > Integrations and find the Workflow App tile for the workspace you want to connect. Click Connect.
Ravenna Integrations page with the Workflow App tile and Connect dialog
3

Enter the credentials

Paste the App ID and Signing Secret, then save.
  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 to get started.
1

Open Workflow Builder

In Slack, click Tools in the sidebar and select Workflows. You can also press ⌘+K / Ctrl+K and search for “Workflows”.
2

Create a workflow and choose a trigger

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

Add the Ravenna step

Click Add Steps, search for the name of the custom app you installed, and add the Open Form step.
4

Configure the 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:
    https://app.ravenna.ai/<workspace>/forms/<FORM_ID>
    Copy the <FORM_ID> 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.
5

Finish and publish

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.
Add the workflow to a Slack Canvas for a more visual, organized entry point. See Slack’s guide to sharing a Canvas.

​
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 and using Slack triggers and actions in Ravenna workflows.
Last modified on July 8, 2026