🧹 Jedi Cleaner for Slack

❌ Slack's Limitation

Slack lacks a native bulk delete feature. Users must delete messages manually, which is time-consuming and inefficient for large volumes.

✅ Our Solution

Jedi Cleaner automates Slack message deletion using smart filters, safety confirmations, and enterprise-grade reliability.

---

🚀 Key Features & Capabilities

⚡ Lightning-Fast Bulk Operations

• Delete hundreds of messages in minutes
• Intelligent rate limiting prevents API throttling
• Auto-retry on failure ensures reliable operation

🎯 Smart Message Filtering

• Keyword match – Find messages with specific terms
• User mentions – Target messages that mention specific users
• Exact phrases – Use quotes for precision
• Bot/User content – ​​Handle mixed sources seamlessly

---

🛡️ Enterprise-Grade Safety

• Confirmation workflow – No accidental deletions
• Timeout – Requests expire after 5 minutes
• Preview-first – Review messages before deletion
• Granular control – Choose exactly what to delete

---

🔍 Intelligent Search & Preview

• Flexible filters (words, phrases, patterns)
• Preview + count before deletion
• Multi-channel support with context isolation

📊 Complete Workflow Management

• Auto-cleanup of bot messages after execution
• Real-time progress tracking
• Debug logs and audit trails
• Static data persistence and cleanup

---

🧪 How It Works

Phase 1: Search Request

 User: /cleanup "error messages"
 Bot Response:
 🔍 Found 15 messages containing "error messages"
 📊 Breakdown:
 • Will be permanently deleted
 • Cannot be undone
 • Respond within 5 minutes

 ✅ Type: @cleaner_jedi yes
 ❌ Type: @cleaner_jedi cancel

Phase 2: User Confirmation

 User: @cleaner_jedi yes
 Bot: 🗑️ Deleting 15 messages containing "error messages"

Phase 3: Completion

 ✅ Cleanup Complete
 • 15 messages deleted
 • Channel cleaned
 • Auto-deletes this message in 5 seconds

---

🛠️ Technical Architecture

Core Components

• Unified Webhook Handler
  Handles slash commands & mentions, deduplicates events
• Search Engine
  Integrates Slack API, parses & filters search terms
• Safety & Confirmation System
  Temporary storage, expiration logic, user auth
• Bulk Operations Engine
  Message deletion, progress tracking, error handling
• Cleanup & Memory Management
  Delete bot messages, static data cleanup

---

📱 User Commands

Command	Description	Example
/cleanup [term]	Search messages containing [term]	/cleanup "webhook error"
@cleaner_jedi yes	Confirm deletion	After preview
@cleaner_jedi cancel	Cancel pending deletion	Cancel active request

🧩 Edge Cases

Scenario	Bot Response
No messages found	"No messages found containing '[term]'"
Expired confirmation	"Request expired. Please run /cleanup again"
No pending request	"No pending cleanup found. Run /cleanup first"
Invalid search term	"Please provide a valid search term"

---

⚙️ Setup Requirements

Slack App Configuration

OAuth Scopes:

 ✅ chat:write
 ✅ chat:write.public 
✅ channels: history
 ✅ groups:history
 ✅ app_mentions:read
 ✅ commands

Event Subscriptions:

 ✅ app_mention
 ✅ message.channels

Slash Command:

 Command: /cleanup
 URL: https://your-n8n.app.cloud/webhook/cleanerjedi
 Hint: [search term]

n8n Workflow Setup

Required Nodes:

• Webhook Trigger – Captures Slack events
• Respond to Webhook – Handles routing
• Switch Node – Event type routing
• Slack API Nodes – Search, delete, notify
• JavaScript Nodes – Logic & validation

---

⚡ Advanced Features

🧠 Intelligent Deduplication

 eventId = `cmd_${body.command}_${body.user_id}_${body.trigger_id}`;
 if (staticData.recentEvents.includes(eventId)) {
 return []; // Skip duplicate
 }

🔍 Flexible Search Terms

• Single words: test
• Phrases: "error message"
• Special characters: webhook-failed
• Case-insensitive by default

♻️ Auto-Cleanup

 setTimeout(() => {
 deleteMessage(completionMessage.ts);
 deleteMessage(progressMessage.ts);
 }, 5000);

🧠 Storage Management

• Temp storage for requests
• Auto-expiry cleanup
• Memory-safe event trimming

---

📊 Error Handling & Logging

Error Scenarios

 ❌ Invalid term
 ⏰ Expired request
 🚫 Access denied
 ⚠️ Rate limit hit

Debugging & Monitoring

• Event IDs, timestamps
• Key-value storage info
• API response codes

---

✅ Usage Examples

Example 1: Delete Error Messages

 /cleanup "error"
 → Bot: Found 23 messages
 → @cleaner_jedi yes
 → ✅ Deleted 23 messages

Example 2: Cancel Midway

 /cleanup "from:@john"
 → Bot: Found 8 messages
 → @cleaner_jedi cancel
 → ❌ Operation cancelled

Example 3: Search by Date

 /cleanup "2024-01-15"
 → Bot: Found 12 messages
 → @cleaner_jedi yes
 → ✅ 12 messages deleted

---

🔒 Security & Safety

• ✅ User confirmation required
• ✅ 5-minute time limits
• ✅ Permission-aware deletions
• ✅ Audit trail logging

---

🚀 Performance Optimizations

• Minimal webhook/API usage
• Batch deletion
• Cached recent events

Memory Handling:

• Temp data cleanup
• Key expiration
• Cache trimming

---

📈 Monitoring & Analytics

Metrics Tracked

• Messages per operation
• User response times
• Failure & error rates
• Storage performance

Logging

 console.log('✅ SUCCESS:', operationDetails);
 console.warn('⚠️ WARNING:', warningDetails);
 console.error('❌ ERROR:', errorDetails);
 console.info('ℹ️ INFO:', informationDetails);

---

🎉 Summary

For Users

• ✅ Simple commands
• ✅ Preview + safety
• ✅ Fast processing
• ✅ Clear status feedback

For Admins

• ✅ Lower API load
• ✅ Full logging
• ✅ Resilient to errors
• ✅ Lightweight memory footprint

For Developers

• ✅ Modular, clean code
• ✅ Well-documented
• ✅ Scalable & robust
• ✅ Easy to extend

---

PDF how to do Document Included