Slack Feedback Collector

Collects Slack messages you've reacted to with specific emojis and exports them in a clean, readable format - perfect for performance reviews and peer feedback!

🎯 Use Case

Instead of manually searching through months of Slack messages to write performance reviews, use emoji reactions (like 🦸 superhero) to bookmark great contributions as they happen. This Actor automatically collects all those bookmarked messages and groups them by author.

Perfect for:

• 📝 Performance reviews and peer feedback
• 🏆 Recognizing team contributions
• 📊 Tracking helpful conversations
• 🎓 Collecting learning moments

✨ Features

• ✅ Collects messages based on your emoji reactions
• ✅ Supports multiple emojis (superhero, female_superhero, male_superhero, etc.)
• ✅ Flexible date filtering (last N days or specific date ranges)
• ✅ Cleans Slack formatting for readability
• ✅ Includes thread context
• ✅ Works with public channels, private channels, DMs, and group messages
• ✅ Deduplicates messages (handles Slack API quirks)
• ✅ Export to CSV, JSON, Excel, etc.

🚀 Quick Start

1. Get Your Slack User Token

You need a personal Slack user token (starts with xoxp-). Here's how:

Option A: Create a New App (Recommended)

1. Go to Slack API Apps
2. Click "Create New App" → "From scratch"
3. Give it a name (e.g., "Feedback Collector") and select your workspace
4. Go to "OAuth & Permissions" in the left sidebar
5. Scroll to "Scopes" → "User Token Scopes"
6. Add these scopes:
   • reactions:read - Read your reactions
   • users:read - Read user names
   • channels:read - Read public channel names
   • groups:read - Read private channel names
   • im:read - Read direct messages
   • mpim:read - Read group messages
   • channels:history - Read public channel message history
   • groups:history - Read private channel message history
   • im:history - Read DM history
   • mpim:history - Read group message history
7. Scroll up to "OAuth Tokens for Your Workspace"
8. Click "Install to Workspace" and authorize the app
9. Copy your "User OAuth Token" (starts with xoxp-)

Option B: Use an Existing App

If you already have a Slack app:

1. Go to Your Apps
2. Select your app
3. Go to "OAuth & Permissions"
4. Make sure all the required scopes listed above are added
5. Reinstall the app if you added new scopes
6. Copy your "User OAuth Token" (starts with xoxp-)

⚠️ Important Notes:

• Use a User Token (xoxp-), NOT a Bot Token (xoxb-)
• If your workspace requires admin approval, you'll need to request it
• Keep your token secure - treat it like a password!

2. Configure the Actor

Required:

• User Token: Your Slack user token (xoxp-...)
• Emoji Names: List of emoji names to look for (without colons)
  • Default: superhero, female_superhero, male_superhero

Optional:

• How many days back: Number of days to look back (default: 30)
  • Perfect for scheduled runs (e.g., monthly with 30 days)

3. Run the Actor

Click "Start" and wait for it to complete. The Actor will:

1. Fetch all your reactions from the specified time period
2. Filter for messages with your chosen emojis
3. Deduplicate messages (you may have reacted with multiple emojis)
4. Clean up Slack formatting for readability
5. Export as a clean table

📊 Output Format

Each row in the output contains:

• Author - Person who wrote the message
• Message - Cleaned, human-readable text
• Channel - Channel name (or "Direct Message" / "Group Message")
• Link - Direct link to the message in Slack
• Date - When the message was posted
• Reactions - Which emojis you used

You can export the results as:

• CSV (for Excel/Google Sheets)
• JSON
• Excel
• RSS
• HTML table

🔄 Scheduling & Automation

Monthly Performance Review Schedule

1. Go to the "Schedule" tab in the Actor
2. Set up a monthly schedule:
   • Cron: 0 9 1 * * (9am on the 1st of each month)
   • Input: Set "How many days back" to 30
3. Save the schedule

The Actor will automatically run every month and collect the last 30 days of feedback!

Slack Integration

Get notified when the Actor completes:

1. Go to "Integrations" tab
2. Click "+ Add integration"
3. Select "Slack"
4. Choose trigger: "Run succeeded"
5. Connect your Slack workspace and select a channel
6. Customize the notification message

The notification can include:

• Number of messages found
• Link to the full dataset
• Any custom text you want

💡 Pro Tips

Choosing Good Emojis

Pick emojis that clearly indicate appreciation or recognition:

• 🦸 :superhero:, :female_superhero:, :male_superhero: - Great contributions
• 🌟 :star: - Excellent work
• 🎯 :dart: - On-target insights
• 💡 :bulb: - Great ideas
• 🙏 :pray: - Helpful assistance

Best Practices

1. React as you go - Don't wait until review time, bookmark good work when you see it
2. Be consistent - Use the same emojis throughout the review period
3. Review regularly - Export and review your feedback monthly
4. Multiple emojis OK - The Actor deduplicates, so you can use multiple superhero variants

Date Filtering

• Last 30 days - Perfect for monthly reviews
• Last 90 days - Quarterly reviews
• Last 365 days - Annual reviews
• Custom dates - Use the API with oldestDate and newestDate parameters

🔧 Advanced Usage

API Parameters

When calling the Actor via API, you can use:

{
  "userToken": "xoxp-your-token-here",
  "emojiNames": ["superhero", "star", "trophy"],
  "lastNDays": 30
}

Or with specific dates:

{
  "userToken": "xoxp-your-token-here",
  "emojiNames": ["superhero"],
  "oldestDate": "2025-07-01",
  "newestDate": "2025-12-31"
}

🐛 Troubleshooting

"No messages found"

• Check that you're using the correct emoji names (without colons)
• Verify your token has all required scopes
• Make sure you've actually reacted to messages with those emojis
• Check the date range - you might be looking too far back

"Could not get channel info"

• This is normal for some channels - the Actor will show the channel ID instead
• Private channels may not be accessible if your token doesn't have groups:read

"Rate limit hit"

• The Actor automatically handles rate limits with exponential backoff
• If you have 1000+ reactions, it may take several minutes to complete

📝 Example Workflow

1. Throughout the month: When someone does great work, react with 🦸
2. End of month: Actor runs automatically (or you trigger it manually)
3. Review: Open the dataset in Apify Console
4. Export: Download as CSV or Excel
5. Write reviews: Use the collected feedback to write meaningful peer reviews

🔒 Privacy & Security

• Your Slack token is stored securely in Apify
• The Actor only accesses messages you've reacted to
• All data stays in your Apify account
• You can delete datasets after exporting

📜 License

UNLICENSED - For personal use

---

Need help? Open an issue or contact support at Apify.

Like this Actor? Star it on GitHub! ⭐