Skip to content
shuffl
Get started

Searches the public product guides only. Nothing from a workspace is read, and questions are not saved.

← All guides

Connect Slack

Connect the Shuffl app to Slack, approve new permissions, and know what works on the web without it.

Workspace administrators

Read as MarkdownAll guides as textAgent documentation index

Have your agent do thisPaste the prompt into Claude Code, Cursor or another agent. It follows this guide over MCP and asks before it changes anything others will see.Show the prompt
Help me with "Connect Slack" in my Shuffl workspace.

1. Read the guide: https://shuffl-rebuild.vercel.app/docs/markdown/slack
2. Add Shuffl's MCP server: https://shuffl-rebuild.vercel.app/api/mcp
   Claude Code: claude mcp add --transport http shuffl https://shuffl-rebuild.vercel.app/api/mcp
   When the browser opens, choose my workspace and allow the access the guide needs.
3. Work through the steps in order: Connect Slack. Do what you can over MCP and tell me which steps only I can do in the browser or in Slack.

Show me what you will change and who it affects, and wait for my yes before publishing, inviting or sending anything.

App links open your signed-in workspace. Check the selected workspace before making changes.

Connect Slack

  1. As a company owner or administrator, open Company settings → Slack. Select the Shuffl workspace, then choose Connect Slack. A Slack owner or administrator may need to approve the app.
  2. Shuffl asks to read messages sent to it, post messages, see channels and read the member list. It never reads conversations that do not mention it.
  3. Everyone in your Slack workspace then appears in People, and so does anyone who joins later; bots, guests and deactivated accounts are left out. They wait for access until you enable them.
  4. The person who connected Slack gets a welcome message from Shuffl with the next steps. Send me the welcome again in Company settings → Slack resends it.

Each Slack connection belongs to a company. Enterprise Grid lets you connect the organization once and map its Slack workspaces to Shuffl workspaces. Newly granted Slack workspaces wait for a company administrator to map them. Slack sign-in joins only workspaces where the person has verified membership and enabled access.

Welcome for whoever installs ShufflThe person who connects Slack, in a DM from Shuffl · Right after Slack is connected

ShufflAPP

Welcome to Shuffl

Mello answers your team’s HR questions in Slack.• Only from the Knowledge you approve• Anything it can’t answer goes to HR privately
Setup: 1 of 3 done
1. Finish workspace setupAdd your handbook, ask Mello a question and invite a coworker.
Finish setup
✓ Add knowledgeUpload your handbook or policies so Mello can answer with sources.
Add knowledge
3. Invite employeesGive your team access so they can ask Mello.
Invite employees
Ask Mello• Send a message here• Or mention @Shuffl in a channel• Try “How much PTO do I get?”
Home tabSee setup progress, your bio and Connections in one place.
Open Home
This chat is private. Your manager, HR and workspace admins can’t read it, and it’s deleted after 30 days.
Company settings for Slack, with a Shuffl workspace picker, its connection state and controls for welcome messages, profile links and sign-in access.
Company settings → Slack shows the connection state and every setting that depends on it.

Approve new permissions

When a feature needs a new Slack permission, Manage shows a banner: Slack needs updated permissions. It lists what the reconnect turns on, such as reading PDFs shared in Slack or creating community channels. Choose Reconnect Slack and approve it; nothing else changes and no message is sent.

Company settings → Slack shows the same state on the connection card: Connected, Connected, permissions needed, Reconnect required or Not connected.

What employees see in Slack

The Shuffl app’s Messages tab is a private chat with Mello. Its Home tab starts with Ask Mello, then Today’s question when a Pulse question is open, your praise and where to give it, your communities, Connections programs with a Take a break button, recent introductions, celebrations and your bio.

HR responders, Knowledge reviewers and administrators see what waits on them first: a count at the top, then HR requests and Knowledge to review. Administrators also get Your workspace, with setup progress, how many people answered the open Pulse question, and buttons to People, Praise and Settings. Below that they get every section employees get, so they can answer Pulse, give praise and take part in Connections and communities too.

Each employee gets one welcome message when their access is turned on or they first open the app. It says the chat is private and deleted after 30 days.

In a channel, mention @Shuffl to get an answer in a thread from Knowledge published to everyone. Anything personal is answered only in a direct message.

The message examples in this guide show what employees receive and when.

Employee welcomeEach employee, once, in a DM from Shuffl · When their access is turned on or they first open Shuffl

ShufflAPP

Hi, I’m Mello, Shuffl’s AI. Ask me about time off, benefits, policies or who’s who.• I answer from your company’s approved Knowledge, with sources• If I can’t help, I’ll help you send it to HR
Try asking• Who should I meet at work?• Help me fill in my profile.• Which communities could I join?
Get started
1. Add your photo and bio
Add photo
2. Join a community
See communities
3. Ask Mello something
Ask Mello
Open Home
This chat is private. Your manager, HR and workspace admins can’t read it, and it’s deleted after 30 days.
Home tab for employeesEach employee, on the Shuffl app’s Home tab · Every time they open it

ShufflAPP

Your HR teammate

Open Messages to ask Mello, Shuffl’s AI, about policies, benefits or anything else at work. If you need HR, you’ll review what gets shared before it’s sent.
Ask MelloChat on the webKnowledge

Today’s question

Quick one from Mello · 10 seconds · confidential
I have what I need to do my job well.
Strongly disagreeDisagreeNeutralAgreeStrongly agree
Skip this oneNeed help with this?Who sees my answers?
Open until Thursday 1:00 PM.
Try asking• How much time off do I have left?• Who should I meet at work?

Praise

You were praised 3 times in the last 30 daysLatest from @Priya Natarajan: turning the benefits FAQ around in a day
Give praiseYour praise
Thank someone in #kudos and mention them. Shuffl adds it to their profile.

Communities

You’re in 2 communities• Weekend hikers• Parents at Northwind5 more you can join.
Browse

Connections

Coffee chats · #coffee-chatsYou’re in
Take a break
A break keeps you out of new introductions until it ends or you resume.

Your bio

Product designer. Ask me about Figma, hiking or the best tacos near the office.
Edit bio
Home tab for HR and adminsHR responders, Knowledge reviewers and administrators · Every time they open it

ShufflAPP

Your HR teammate

Waiting on you: 2 HR requests
Open Messages to ask Mello, Shuffl’s AI, about policies, benefits or anything else at work. If you need HR, you’ll review what gets shared before it’s sent.
Ask MelloChat on the webKnowledge

HR requests waiting on you

Can I carry unused vacation days into next year? I have six left.Updated 25 minutes ago
Open
My new address needs to go on my paycheck before the next run.Updated 3 hours ago
Open
Open Needs you
Draft replies with Shuffl in Messages. Drafts stay private until you choose Send.

Your workspace

Pulse is openI have what I need to do my job well.31 of 42 answered (74%) · closes Thursday 1:00 PM
Open Pulse
PeoplePraiseSettings

Today’s question

Quick one from Mello · 10 seconds · confidential
I have what I need to do my job well.
Strongly disagreeDisagreeNeutralAgreeStrongly agree
Skip this oneNeed help with this?Who sees my answers?
Open until Thursday 1:00 PM.
Try asking• How much time off do I have left?• Who should I meet at work?

Praise

You were praised 3 times in the last 30 daysLatest from @Priya Natarajan: turning the benefits FAQ around in a day
Give praiseYour praise
Thank someone in #kudos and mention them. Shuffl adds it to their profile.

Communities

You’re in 2 communities• Weekend hikers• Parents at Northwind5 more you can join.
Browse

Connections

Coffee chats · #coffee-chatsYou’re in
Take a break
A break keeps you out of new introductions until it ends or you resume.

Your bio

Product designer. Ask me about Figma, hiking or the best tacos near the office.
Edit bio
Hello in a channelA channel · When someone adds Shuffl to it

ShufflAPP

Mello is here.• Mention @Shuffl with a question and I’ll reply in a thread• Answers come from your company’s approved Knowledge• For anything personal, message me directly. Those chats are private.
Everyone can open Shuffl’s Home tab to find Knowledge.

Shuffl can put a link to each person’s Shuffl profile on their Slack profile. It needs a paid Slack plan, profile-editing permission from the person who connected Slack, and a Link field named Shuffl profile; Company settings → Slack shows which are in place. Turn the switch on and choose Sync now; turning it off removes the links.

Enable people who join a program channel

Program channel access enables someone who is waiting for access as soon as they join a channel that a Connections program uses. Leave it off to enable people by hand in People.

What works without Slack

Chat, HR requests, Knowledge, People, profiles, Praise and every report and setting work on the web. Pulse questions, HR requests and the HR digest can go by email, under Settings → Notifications.

Introductions, onboarding messages, praise capture, celebration posts and community channels need Slack connected and the person’s Slack account linked in People.