🧹 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 trail
• 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
  Deletes 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	Cancels 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