Setup & Installation

Setting up Mellowe for your team takes under 2 minutes. Follow this guide to connect Mellowe to your Slack workspace.

Requirements

• A Slack workspace where you have Workspace Admin or Owner permissions (or approval to install apps).
• A Mellowe account (created during the setup process).

---

Installation Steps

Step 1: Add to Slack

1. Go to the Mellowe Website and click “Add to Slack”.
2. You will be redirected to Slack’s OAuth authorization page.
3. Select the Slack workspace you want to install Mellowe.

Step 2: Grant Permissions

Mellowe requires the following standard Slack bot permissions to function:

• commands: Allows users to trigger Mellowe commands like /mellowe or /taco.
• chat:write: Enables Mellowe to post recognition messages and announcements in public channels.
• users:read: Allows Mellowe to sync team member names, avatars, and profile details.
• channels:read: Enables channel selection for public recognition feeds.

Click Allow to authorize Mellowe.

Step 3: Choose Your Primary Recognition Channel

Once authorized, you will be directed to the Mellowe Admin Setup screen:

1. Select your primary public channel (e.g., #recognition, #kudos, or #general).
2. Set your default daily giving allowance per user (default is 5 recognitions per day).
3. Click Finish Setup.

---

Verifying the Installation

To verify Mellowe is working in Slack:

1. Go to any public channel where Mellowe was added.
2. Type @Mellowe help or send a test recognition:

   @alex Thanks for helping with the deployment today! 👏 #teamwork

3. Mellowe will respond with a confirmation message verifying that points/badges were awarded.