Bulk Delete Slack Messages with Smart Filtering and Confirmations

Description

🧹 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