AndreasThinks / slack-omnivore-reader

A Slack bot and accompany FastAPI back-end to automatically read in documents from a channel to an Omnivore list.

Slack Omnivore Integration

This application integrates Slack with Omnivore, allowing you to save URLs shared in Slack to your Omnivore account.

Features

• Saves URLs shared in Slack to Omnivore when specific emoji reactions are added
• Configurable trigger emojis
• Applies custom labels to saved articles
• Configurable rate limiting
• Secure handling of environment variables

Deployment

Click the "Deploy to Heroku" button above to start the deployment process. Don't worry if you don't have all of these yet, you'll get the rest after deploying your Slack App.

• SLACK_BOT_TOKEN: Your Slack Bot Token
• SLACK_SIGNING_SECRET: Your Slack Signing Secret
• OMNIVORE_API_KEY: Your Omnivore API Key
• ALLOWED_HOSTS: Comma-separated list of allowed hosts (e.g., your-app-name.herokuapp.com)
• OMNIVORE_LABEL: (Optional) Label to apply to saved articles in Omnivore (default: "slack-import")
• RATE_LIMIT_PER_MINUTE: (Optional) Number of requests allowed per minute (default: 3)
• TRIGGER_EMOJIS: (Optional) Comma-separated list of emojis that trigger the bot (e.g., "bookmark,star,heart"). If not set, the bot will respond to any emoji reaction.

Usage

1. Add the Slack bot to your workspace and invite it to the desired channels.
2. When a message containing a URL is posted, react to it with one of the specified emojis (or any emoji if TRIGGER_EMOJIS is not set).
3. The bot will extract the URL, save it to Omnivore with the specified label, and post a confirmation message in the thread.

Installation

To add the application to Slack, you must have deployed the back-end on Heroku using the process above.

Once this is complete, you can create an application on your Slack workspace (you will need administrator permissions). You can either use our Slack Manifest, or follow the manual steps below.

• In the "oAuth & Permissions" section, enable channels:history, chat:write and reactions:read, and obtain your SLACK_BOT_TOKEN.
• In the "Event Subscriptions" section, add "reaction_added" to bot events

Once your bot has been installed, follow the configuration steps below.

• In the "Event Subscriptions" section, add your full Heroku application URL (in the format https://your-heroku-app.herokuapp.com/slack/events) as the request URL.
• If you do not already have one, create an Omnivore account, and get an API key.
• From the Heroku web-interface, add all environment variables to your application.
• From within your Slack client, add your bot to a channel by sending them a DM

That's it! Test it by reacting to a post with a valid URL. You should be able to see the event in your Heroku logs, and it will appear in your Omnivore library.

Local Development

1. Clone this repository
2. Create a .env file with the required environment variables (see above)
3. Install dependencies: pip install -r requirements.txt
4. Run the application: python main.py

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache 2.0 License.