Archive Bot

Slack bot helper for managing outdated and very small channels.

Configuration

Archive bot needs a bit of data to get started:

• Slack API Key
• Notification Channel ID
• Filter Prefixes (optional)
• Messages (optional)
• Staleness (optional)
• Small Channel Threshold (optional)

rust let config = archive_bot::Config { token: env::var("SLACK_BOT_TOKEN").expect("Error: environment variable SLACK_BOT_TOKEN is not set."), notification_channel_id: env::var("SLACK_CHANNEL_ID").expect("Error: environment variable SLACK_CHANNEL_ID is not set."), filter_prefixes: vec!["-"], message_headers: vec![ "Hey, you've got some cleaning up to do!", "Hey boss, take a look at these, will ya?", ], stale_after: 2 * 7 * 24 * 60 * 60, small_channel_threshold: 3, };

Or, using default values:

rust let config = archive_bot::Config { token: env::var("SLACK_BOT_TOKEN").expect("Error: environment variable SLACK_BOT_TOKEN is not set."), notification_channel_id: "A01A02A03A04".to_string(), ..archive_bot::Config::default() };

Implementation

Currently this bot consists of a single runtime, with a single action. Further actions and config options TBD.

rust match archive_bot::run(&config).await { Ok(_) => println!("Success!"), Err(e) => panic!("Uhoh! {:}", e), }

See the examples directory for further implementation details.

Setting Up Slack

See Slack documentation for basic app setup.

Generate your Bot User OAuth Token on the Slack API Admin > [Your App] > Features > OAuth & Permissions.

Your app needs the following scopes:

• channels:history
• channels:join
• channels:read
• chat:write
• groups:history
• groups:read

Logging

Archive Bot implements the log crate and does not produce output directly. See the examples directory for an implementation of simplelog.

Finding Slack Channel ID

To find the ID of a Slack channel, you can click the channel name for more info and find it at the bottom.