--- title: "Custom Slack App Setup in Unleash" slug: "custom-app" updated: 2025-10-22T12:47:21Z published: 2025-10-22T12:47:21Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.unleash.so/llms.txt > Use this file to discover all available pages before exploring further. # Custom Slack App Setup in Unleash Workspace admins can create a fully customized Slack app tailored to their team’s needs and personalize key elements like slash commands, app descriptions, and app settings directly within the Unleash platform. This app functions like the default [Unleash app for Slack](/v1/docs/slack-search-assistant), enabling users to DM the app, invite a bot to channels, chat with the assistant, and manage its behavior through the Assistant Configuration page in Unleash. This feature gives your organization full control over how Unleash appears and functions in Slack. It supports white-labeling, granular permission management, and provides a seamless, branded experience across workspaces. > **Required permissions for setup:** The user setting up this data source must be an Unleash Workspace Admin and a Slack Workspace Owner or Slack Workspace Admin. You can check whether you have this Slack permission using this [slack guide.](https://slack.com/help/articles/360003534892-Browse-people-and-user-groups-in-Slack#find-owners-and-admins) [Video](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Rachel's%20Video%20-%20Jul%2027,%202025-VEED(1).mp4) ## **Creating a Custom Slack App in Unleash** ### **Part 1: Create the Slack App** Before starting in Unleash, you’ll need to create a Slack app in your workspace: - Go to [Your Apps](https://api.slack.com/apps) in Slack. - Click **Create New App**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1751961577785.png) - Select **From a manifest**. ![Instructions for creating a Slack app with options for configuration and agreement.](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1751961508518.png) - Choose the Slack workspace where the app will live, then click **Next**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-13 at 12.15.34.png) - Delete the content in the manifest. The manifest should be left blank. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-13 at 12.17.04.png) - Pause here, you'll return after generating the manifest in Unleash. ### **Part 2: Create the Custom App in Unleash** **In a new tab, open Unleash:** - Navigate to ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Group 2413(2).png) **Control Center** in Unleash. - Under **Add-ons**, select ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Vector (3)(1).png) **Experiences**. - Find the Slack section and click **+ Create New**. - Click **Custom App**. - Provide your app with a **name** and **description**, then click **Next**. ![Creating a custom app in Unleash with fields for app name and description.](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-07-09 at 11.13.59.png) **Customizing the app behavior:** - Enable or disable slash commands, and optionally rename them. - Slash commands must start with a slash, be all lowercase, and contain no spaces. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-07-08 at 11.31.05.png) - Click **Next**. - Choose which shortcut actions appear in the message kebab menu in Slack, and rename if needed. - Shortcuts can include a space and be more than one word. A good shortcut name is short and descriptive. Please use sentence case. ![Customize shortcuts in Slack with options for answering, recapping, searching, and creating cards.](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-07-08 at 11.29.39.png) - Click **Next**. - On the Manifest screen, click **Copy** and return to Slack. - We suggest you make any changes to the manifest in Unleash first and then copy the updated manifest to Slack to avoid mismatches. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Administration_Slack (2).png) - Open the Slack screen from Part 1 where you started creating the app. - Paste the manifest into the **Create app from manifest** field in Slack. ![Creating a Slack app from a manifest with JSON configuration details displayed.](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1751963848480.png) - Click **Next**. - On the next screen, click **Create**. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Screenshot 2025-08-13 at 12.22.43.png) - Copy the following values from Slack: - App ID - Client ID - Client Secret - Signing Secret ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1751964274040.png) - Paste these into the corresponding fields in Unleash. ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/Administration_Slack (1).png) - Click **Save and Install** in Unleash. - A new tab will open with the Slack app installation page. Click **Allow.** ![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1751971929414.png) - Once installed, the app will appear in Slack’s sidebar under Apps, and you can start interacting with it immediately. - From Unleash, admins can configure whether members can invite assistants to all channels or only selected ones in Slack. [Learn more about Slack Add-on settings](/v1/docs/slack-add-on). ## Chatting with the Custom App Think of the custom app as your personal answering machine. If an answer is found, it will include the source of the information, with clickable links for further details and any other related links. - From Slack, under Apps, click on the custom bot. - On the top menu, click on **Chat.** - Type your question and hit **Enter.** - Give a thumbs up or down on the relevance of the answer. - We encourage feedback on the app's generated answers to enhance our algorithm. When negative feedback is received, we enable the user to provide a reason for the feedback and, if possible, add the URL for a correct answer, allowing us to understand better what went wrong. > **Note:** When DMing the custom app, answers to questions are sourced from all the knowledge connected to Unleash. ## Creating Channel Assistants with the Custom Slack App You can create channel assistants using your custom Slack app and configure each assistant to answer questions based on the data sources you assign to that specific channel. To set up a channel assistant with your custom app, [follow the steps outlined in this guide.](/v1/docs/slack-channel-assistant#step-1-creating-a-slack-channel-assistant) > **Note:** When asking questions in channels with an invited channel assistant, answers are sourced from the knowledge resources configured for that channel. ## Using Slash Commands From any DM or channel, you can use the slash commands you’ve configured. These slash commands allow you to: - **/ask** Use this command followed by your question. If an answer is available, it will be shown only to you. In channels where [expert verification](/v1/docs/slack-channel-assistant#require-expert-validation-before-publishing-an-answer)is enabled, the answer will only be shared after it has been reviewed and approved by an expert. - **/recap** Get a private summary of the conversation. You can choose to share it in the thread to make it visible to others in the channel . **Recaps are only available in channels where the bot has been invited**. Learn more about [refining your recap query.](/v1/docs/slack-channel-assistant#recapping-messages) - **/find** Run a search directly from Slack. Results are visible only to you. Use this command followed by your search query and hit enter. Click the results to open them in Unleash for full context. - **/go** Type the command followed by the name of your Go Link to share it in the channel or DM.[Learn more about Go Links.](/v1/docs/go-links) > **Note:**When using /ask or /find in a channel where the bot is invited, the answer is based on the sources configured for that channel. If you use these commands in a channel where the bot is not invited, the answer will be generated using only the sources available to you personally, rather than any channel-specific settings. ## Using Chat Shortcuts From any message in a DM or channel, click the message and open the kebab menu (⋮) to access the custom shortcuts you’ve configured. These shortcuts let you: - **Answer a question** Generate a response based on your connected knowledge in Unleash. The answer will be posted publicly as a reply in the thread, visible to the channel or the person you're DMing. - **Recap the thread** Get a private summary of the conversation. You can choose to share it in the thread to make it visible to others in the channel. **Recaps are only available in channels where the bot has been invited** - **Search Unleash** Run a search directly from Slack. Results are visible only to you. Click to open them in Slack or view them in Unleash for full context. - **Create a card** Opens a form to create a new knowledge card. Add a title, content, and assign it to a collection in Unleash. Once saved, it becomes accessible to your team via the wiki. > **Note:** Except for the Answer action (which replies publicly), all other actions are private by default. When available, you can choose to share results in the channel or DM thread. ## Slack Agent for your Custom App Chat with your company knowledge to get instant answers, ask follow-up questions, and access your company’s knowledge, without switching contexts. Unlike channel-based assistants, the Slack Agent gives you access to **all the knowledge connected to your Unleash workspace**, regardless of which channel or conversation you're in. > **Note**: You can create custom [Slack AI Agents](/v1/docs/ai-agent)and configure them with selected knowledge sources, enabling them to answer questions on specific topics tailored to your needs. **To pin the Unleash Assistant to the top bar:** - Open the **Unleash** app in Slack. - From your desktop, click your profile picture in the sidebar. - Select **Preferences** from the menu. - Click **Navigation.** - Under **App agents & assistants**, check the box next to the app you’d like to display. Uncheck the box to hide it. For more information, [view the Slack documentation](https://slack.com/help/articles/33076000248851-Understand-AI-apps-in-Slack).