Slack Fetch Bot

Slack Fetch Bot is a Python-based chatbot that can fetch information from various APIs and send them as Slack messages. It can be used to schedule messages, save conversation history, and monitor subreddits for new posts. In addition, the bot can communicate with users via direct messages using the new Bing, with the support of EdgeGPT. With the ability to download images and present them in an HTML format, the bot provides a versatile and user-friendly way to keep up-to-date with various sources of information. See the README.md file for more information.

Features

Slack Fetch Bot currently supports the following features:

• Weather information: Get weather information for a specified location using the OpenWeatherMap API.
• Random quotes/facts: Get a random quote or fact using the Quotable API or the uselessfacts API.
• Random image of shiba inu: Get a random image of a Shiba Inu using the shibe.online API.
• Retrieve and store conversation history with auto-downloaded image files from Slack based on a given schedule to a JSON file or on request.
• Convert conversation history JSON files to HTML format, which supports for all major browsers
• Monitor a subreddit and send new posts to a designated channel
• Chat with users by using the new Bing

Conversation History Retrieval

Note: Before requesting the bot to get conversation history, you need to make sure that the bot has been added to the specific channel you want to retrieve the history from.

The bot can retrieve and store conversation history from Slack based on a given schedule to a JSON file or on request. You are welcome to modify the output format by modifying the save_history::save_conversation_history() function. The Slack API endpoint used for this feature is conversations.history. More information on this API endpoint can be found in the official Slack API documentation.

Chat With The Bot

In addition to fetching information and scheduling messages, the Slack Fetch Bot can also chat with users via direct messages. This feature is enabled through integration with the new Bing using EdgeGPT.

To use this feature, it is recommended to first install EdgeGPT by running the following command in your terminal:

python3 -m pip install EdgeGPT --upgrade

Next, ensure that you have an account that can be used to chat with the new Bing. You will need to locate the cookies file associated with this account, which can be found by following the instructions outlined in the EdgeGPT.

Requirements

You can install these dependencies using pip with the following command:

pip install -r requirement.txt

To avoid any potential conflicts with other Python packages, it is strongly recommended to run this command within a virtual environment specific to your project.

In addition to these packages, you'll need to create a Slack bot and obtain its API token. To do this, follow these steps:

1. Go to the Slack API website and create a new app.
2. You can follow the steps in the Slack API documentation to create your bot.

or

2. To simplify the deployment of your bot, it is recommended to use a manifest.yml file to define your app's configuration and deploy it to your workspace using the Slack App Manager. A sample manifest.yml file is included in this project.

3. Copy the "Bot User OAuth Access Token" from the "OAuth & Permissions" section of your app settings.

4. From Settings->Basic Information->App-Level Tokens, create && copy a token with a scope of connections:write.

Installation

To install Slack Fetch Bot, follow these steps:

1. Create a new Slack app and bot user on your Slack workspace.
2. Modify your bot's OAuth token in fetch_bot.py : SLACK_APP_TOKEN=your_app_token (xapp-) and SLACK_BOT_TOKEN=your_bot_token (xoxb-). (Optional) You will also need a key to use the Weather API from OpenWeatherMap.
3. (Optional) The fetch_bot.py file includes a commented section in the main class that allows you to schedule messages to be sent to a specific Slack channel. To use this feature, simply uncomment the relevant code and edit it according to your needs.
4. "Customize the bot's functionality by modifying the fetch_bot.py file to suit your needs. Don't be afraid to get creative!

Usage

To start the bot, export the following environment variables with your corresponding values:

export SLACK_BOT_TOKEN="your_slack_bot_token"
export SLACK_APP_TOKEN="your_slack_app_token"
export WEATHER_API_KEY="your_weather_api_key"
export COOKIE_FILE="/your/folder/for/cookie.json"

Then run the following command:

python3 fetch_bot.py

To stop the app, press Ctrl+C in the terminal.

To run the app in the background, run the following command in the terminal:

nohup python3 fetch_bot.py &

To stop the app, run the following command in the terminal:

ps -ef | grep fetch_bot.py
kill -9 <process id>

Once the bot is running, it will listen for events on your Slack workspace and respond accordingly.

Example

Once you have set up the fetch_bot.py file and have configured the Slack bot, you can use the bot to fetch information and send it to your Slack channel.

Contributing

If you'd like to contribute to Slack Fetch Bot, feel free to submit a pull request or open an issue.

License

Slack Fetch Bot is licensed under the MIT License. See LICENSE for more information.