📝 Overview

To use certain Slack triggers, you'll need to register Yoom within your Slack workspace. This is a one-time setup that ensures Yoom and Slack can communicate. Think of it as introducing Yoom to your Slack workspace so they can start working together.

🛠️ How to Set Up

1. Copy Yoom's Webhook URL

First, navigate to the Slack app trigger screen in Yoom.

Copy the "Webhook URL".

2. Create your Slack app

Go to the Slack API Apps page and click the "Create New App" button in the top-right corner.

From the configuration options, select “From a manifest”.

Choose the Slack workspace where you want to use the trigger and click "Next".

In the text box provided, replace the existing content with the JSON code below.

☝️ Note: Be sure to replace {Paste Yoom's Webhook URL here} with the URL you copied in Step 1.

{
  "display_information": {
    "name": "YoomTrigger",
    "description": "This is Yoom's Slack app.",
    "background_color": "#0A6982"
  },
  "features": {
    "bot_user": {
      "display_name": "YoomTrigger"
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "channels:history",
        "groups:history",
        "reactions:read",
        "channels:read",
        "app_mentions:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "{Please specify Yoom's Webhook URL here.}",
      "bot_events": [
        "channel_created",
        "message.channels",
        "message.groups",
        "reaction_added",
        "app_mention"
      ]
    }
  }
}

Once you've pasted the code and added your URL, click "Next".

Then click "Create".

3. Customize your app (optional)

If you'd like to give your app a personal touch, select "Basic information" from the sidebar.

Scroll down to the "Display Information" section to upload an icon or change the app's name.

4. Verify the Webhook

In the Slack app sidebar, go to “Event Subscriptions”.

Locate the "Request URL" field and click the "Retry" button next to it.

Once you see the green "Verified" checkmark, click "Save Changes" at the bottom of the page.

5. Install & invite the app

Now it's time to bring the app into your workspace.

Go to “Install App” in the sidebar and click “Install to {workspace name}”.

Go to the Slack channel you want to connect to and type the following command to invite the app:

/invite @YoomTrigger

⭐️ If you chose a different name for your app in step 3, use that name instead.

e.g., “/invite @{app name}”.

☝️ Note: Only channels where the app has been invited will be able to trigger your Yoom workflows.

🎈 Troubleshooting

If your app doesn't appear when typing the '/invite' command, try this manual method:

Right-click the channel name in Slack and select “View channel details”.
Click the “Integrations” tab and then click “Add apps”.
Search for your app name and click "Add".

That completes the setup 🎉

Your Flowbots are now ready to take action whenever an event occurs in your selected Slack channel.

📚 Related Guides

How to Register Slack in Yoom - View Guide Here
How to Send Hyperlinked Text in Slack - View Guide Here

Search Keywords

Slack app, webhook setup, Slack trigger, manifest, invite bot, verified webhook, integration guide

Slack: Setting Up Webhook Triggers