{"id":15450822,"url":"https://github.com/dansantander/ruby-slackbot","last_synced_at":"2025-05-16T06:09:11.951Z","repository":{"id":131637437,"uuid":"251337701","full_name":"dansantander/ruby-slackbot","owner":"dansantander","description":"A simple news bot for Slack fed through CNN International news website.","archived":false,"fork":false,"pushed_at":"2020-04-01T23:21:24.000Z","size":2363,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"development","last_synced_at":"2025-02-17T16:52:30.782Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dansantander.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-30T14:54:21.000Z","updated_at":"2020-07-15T22:25:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"9e3e9427-f057-4bf5-bf00-0aadbc2a2e70","html_url":"https://github.com/dansantander/ruby-slackbot","commit_stats":{"total_commits":33,"total_committers":2,"mean_commits":16.5,"dds":"0.030303030303030276","last_synced_commit":"cedaccbf806cdcba421fff33f94d5181728bcc56"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dansantander%2Fruby-slackbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dansantander%2Fruby-slackbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dansantander%2Fruby-slackbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dansantander%2Fruby-slackbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dansantander","download_url":"https://codeload.github.com/dansantander/ruby-slackbot/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478193,"owners_count":22077676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T21:20:22.194Z","updated_at":"2025-05-16T06:09:08.261Z","avatar_url":"https://github.com/dansantander.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RUBY SLACK BOT\n\nThe purpose of this project was to build a bot with Ruby. I chose to build a Slack Bot because it's the platform I use the most for communicating with my coding mates. Also, I built this bot thinking about what could be useful for every team in Slack without necessarily getting into the tech or programming field, so that's the reason why I made a newsbot. When called, it delivers a link to a piece of news from the CNN International website.\n\n\nProject: Ruby Capstone Project - Ruby Slack Bot\n\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \n  \u003ch2 align=\"center\"\u003eNEWSBOT\u003c/h2\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/dansantander/ruby-slackbot\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    ·\n    \u003ca href=\"https://github.com/dansantander/ruby-slackbot/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/dansantander/ruby-slackbot/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n* [Getting Started](#getting-started)\n* [About the Project](#about-the-project)\n* [Built With](#built-with)\n* [Acknowledgements](#acknowledgements)\n* [License](#license)\n* [Contact](#contact)\n\n## Getting Started\n\n### Prerequisites\nYou should have installed:\n- Ruby\n- [Bundler](https://bundler.io/)\n\nYou will need to:\n- Create a Slack workspace [here](https://slack.com/create#email). Note: If you want the bot to be running inside an already existing workspace, you'll need administrator permissions.\n- Have a Slack API Token. You can get one by creating an app [here](http://slack.com/services/new/bot). Your Slack API Token is the one that starts with `xoxb-`. Remember to save it somewhere safe. You'll use it later.\n- Personalize your bot (name, icon, etc.).\n\n### Install\n\n- Download or clone this project into your local machine.\n- As this repository already has a Gemfile ready, you should install all the dependencies by running `bundle` in your terminal inside your project directory. You can also use the `bundle install` command for this purpose. See more about it [here](https://bundler.io/v2.0/man/bundle-install.1.html). If everything went well with the installation for this step, you should now have a file named `Gemfile.lock` inside your project directory.\n\n### Usage\n\n- To start using the bot you'll need to create a file named `.env` in the root folder of the project and paste in your Slack API Token as follows:\n`SLACK_API_TOKEN=\u003cyour token\u003e`\n- Once you have everything set, you can start the bot by running `rackup` from your terminal inside the main directory.\n- After the bot is running, open Slack and add the workspace you created. You can invite the bot to a Slack channel like this:\n\n![invite](./gifs/invite.gif)\n\n(Your bot will appear with the name and the icon you set before)\nAnd off you go! Hope you enjoy it. :)\n\n## Commands\n\n### help\n\n![help](./gifs/help.gif)\n\n### get_news\n\n![get_news](./gifs/getnews.gif)\n\n### get_news (topic)\n\n![get_news topic](./gifs/getnewstopics.gif)\n\n## About The Project\n\nThis project was built following the next Microverse requirements:\n\n- [x] A bot developed in Ruby.\n- [x] Recommended platforms: [Slack](https://github.com/slack-ruby/slack-ruby-bot), [Twitter](https://github.com/muffinista/chatterbot), [Telegram](https://github.com/atipugin/telegram-bot-ruby).\n- [x] You choose the platform and the functionality of the bot.\n- [x] The README must include instructions on how to use the bot (how to install it and use it).\n\n## Built With\n* Ruby\n* Slack-Ruby-Bot\n* celluloid-io\n* dotenv\n* puma\n\n## Acknowledgments\n\nThis project was possible thanks to the [Slack Ruby Bot](https://github.com/slack-ruby/slack-ruby-bot) team.\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n## Contact\n\nDaniel Santander - [Github profile](https://github.com/dansantander)\u003cbr\u003e\nProject Link: [https://github.com/dansantander/ruby-slackbot](https://github.com/dansantander/ruby-slackbot)\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/othneildrew/Best-README-Template.svg?style=flat-square\n[contributors-url]: https://github.com/RodolfoRodriguezMata/enumerable-methods/contributors\n[forks-shield]: https://img.shields.io/github/forks/othneildrew/Best-README-Template.svg?style=flat-square\n[forks-url]: https://github.com/othneildrew/Best-README-Template/network/members\n[stars-shield]: https://img.shields.io/github/stars/othneildrew/Best-README-Template.svg?style=flat-square\n[stars-url]: https://github.com/othneildrew/Best-README-Template/stargazers\n[issues-shield]: https://img.shields.io/github/issues/othneildrew/Best-README-Template.svg?style=flat-square\n[issues-url]: https://github.com/othneildrew/Best-README-Template/issues\n[license-shield]: https://img.shields.io/github/license/othneildrew/Best-README-Template.svg?style=flat-square\n[license-url]: https://github.com/othneildrew/Best-README-Template/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/othneildrew\n[product-screenshot]: images/screenshot.png","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdansantander%2Fruby-slackbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdansantander%2Fruby-slackbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdansantander%2Fruby-slackbot/lists"}