{"id":13485945,"url":"https://github.com/rampatra/jbot","last_synced_at":"2025-05-14T13:08:17.440Z","repository":{"id":43012081,"uuid":"60470713","full_name":"rampatra/jbot","owner":"rampatra","description":"Make Slack and Facebook Bots in Java.","archived":false,"fork":false,"pushed_at":"2025-04-18T13:22:59.000Z","size":45812,"stargazers_count":1201,"open_issues_count":77,"forks_count":348,"subscribers_count":52,"default_branch":"master","last_synced_at":"2025-05-06T07:37:36.693Z","etag":null,"topics":["bot","bot-framework","conversation","facebook","facebook-bot","java","java8","jbot","messenger-bot","messenger-bot-boilerplate","slack","slack-bot","slack-webhooks","slackbot","slash-commands","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rampatra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":"rampatra","open_collective":"jbot","ko_fi":"rampatra","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://www.paypal.me/iamrampatra"}},"created_at":"2016-06-05T16:54:31.000Z","updated_at":"2025-04-28T12:11:44.000Z","dependencies_parsed_at":"2025-01-16T13:43:30.333Z","dependency_job_id":null,"html_url":"https://github.com/rampatra/jbot","commit_stats":{"total_commits":297,"total_committers":23,"mean_commits":12.91304347826087,"dds":"0.14141414141414144","last_synced_commit":"a84e0127a92f2d0b165ceb0d216a4c4bfd7f7cd8"},"previous_names":["ramswaroop/jbot","ramswaroop/botkit"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampatra%2Fjbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampatra%2Fjbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampatra%2Fjbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rampatra%2Fjbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rampatra","download_url":"https://codeload.github.com/rampatra/jbot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149967,"owners_count":22022852,"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":["bot","bot-framework","conversation","facebook","facebook-bot","java","java8","jbot","messenger-bot","messenger-bot-boilerplate","slack","slack-bot","slack-webhooks","slackbot","slash-commands","spring-boot"],"created_at":"2024-07-31T18:00:34.749Z","updated_at":"2025-05-14T13:08:17.432Z","avatar_url":"https://github.com/rampatra.png","language":"Java","readme":"# JBot [![Build Status](https://travis-ci.org/rampatra/jbot.svg?branch=master)](https://travis-ci.org/rampatra/jbot) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/aa94e04874154ff2bb3d42f2b600ac55)](https://www.codacy.com/gh/rampatra/jbot/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=rampatra/jbot\u0026amp;utm_campaign=Badge_Grade) [![Javadocs](http://www.javadoc.io/badge/me.ramswaroop.jbot/jbot.svg?color=orange)](http://www.javadoc.io/doc/me.ramswaroop.jbot/jbot) [![Facebook](https://img.shields.io/badge/social-fb-blue.svg)](https://www.facebook.com/jbotframework/) [![Backers on Open Collective](https://opencollective.com/jbot/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/jbot/sponsors/badge.svg)](#sponsors) [![MIT license](https://img.shields.io/badge/license-GPL_3.0-yellow.svg)](https://raw.githubusercontent.com/ramswaroop/jbot/master/LICENSE)\n\nMake bots in Java.\n\n__JBot__ is a java framework _(inspired by [Howdyai's Botkit](https://github.com/howdyai/botkit))_ to\nmake Slack and Facebook bots in minutes. It provides all the boilerplate code needed so that you\ncan make your bot live right away.\n\n## Why use JBot?\n\n* Provides you with __all the boilerplate code__ which handles underlying websocket connections and other complexities.\n* Supports __extra events__ in addition to all the events supported by Slack/Facebook which makes your work a lot more easier.\n* __Receiving \u0026 sending messages__ is as easy as defining a `@Controller` and calling `reply()`.\n* __Conversation feature__ of JBot makes talking to your bot a breeze. This feature makes JBot different than rest of the Java frameworks out there.\n* __Well tested__ with good coverage unit tests.\n* And many other features which can't just be mentioned here.\n\n**Not satisfied?** Read on...\n\n* JBot got more than __400 stars__ in just 2 days after release.\n* It is in the [Hacker News](https://news.ycombinator.com/item?id=12239667) 50 club.\n* Chosen by [DZone daily picks](http://mailer.dzone.com/display.php?M=15184241\u0026C=dcebb6887365120539df1fbf19a071ed\u0026S=9043\u0026L=658\u0026N=4604).\n* Last but not the least, it's listed on [Slack.com](https://api.slack.com/community)\n\n**Still worried?** Open an [issue on Github](https://github.com/rampatra/jbot/issues) and we can discuss.\n\n## JBot for Slack\n\n**Running your SlackBot is just 4 easy steps:**\n  \n1. Clone this project `$ git clone https://github.com/rampatra/jbot.git`.  \n2. [Create a slack bot](https://my.slack.com/services/new/bot) and get your slack token.  \n3. Paste the token in [application.properties](/jbot-example/src/main/resources/application.properties) file.  \n4. Run the example application by running `JBotApplication` in your IDE or via commandline: \n    ```bash\n    $ cd jbot\n    $ mvn clean install\n    $ cd jbot-example\n    $ mvn spring-boot:run\n    ```\n\nYou can now start talking with your bot ;)\n\nRead the detailed [Slack documentation](https://blog.rampatra.com/how-to-make-a-slack-bot-in-java) to learn more.\n\n## JBot for Facebook\n\n**Similar to Slack, Facebook is simple too but has a few extra steps:**\n\n1. Clone this project `$ git clone git@github.com:rampatra/jbot.git`.\n2. Create a [facebook app](https://developers.facebook.com/docs/apps/register#create-app) and a \n[page](https://www.facebook.com/pages/create).\n3. Generate a Page Access Token for the page (inside app's messenger settings).\n4. Paste the token created above in [application.properties](/jbot-example/src/main/resources/application.properties) file.\n5. Run the example application by running `JBotApplication` in your IDE or via commandline: \n    ```bash\n    $ cd jbot\n    $ mvn clean install\n    $ cd jbot-example\n    $ mvn spring-boot:run\n    ```\n6. Setup webhook to receive messages and other events. You need to have a public address to setup webhook. You may use\n[localtunnel.me](https://localtunnel.me) to generate a public address if you're running locally on your machine.\n7. Specify the address created above in \"Callback Url\" field under \"Webooks\" setting and give the verify token \nas `fb_token_for_jbot` and click \"Verify and Save\".\n\nYou can now start messaging your bot by going to the facebook page and clicking on the \"Send message\" button. \n\n~_If you're too lazy to start now and just want to play around, you can try `jbot-example` by visiting \n[JBot facebook page](https://www.facebook.com/jbotframework/) and clicking on the \"Send Message\" button._~ -- The server is currently down\n\nRead the detailed [Facebook documentation](https://blog.rampatra.com/how-to-make-facebook-bots-in-java) to learn more.\n\n## Contributors\n\nThis project exists thanks to all the awesome people who contribute. If you want to flaunt your skills and make \nthe project better, [you can start contributing](/CONTRIBUTING.md), and for any queries please just \n[raise an issue](https://github.com/rampatra/jbot/issues) and I would be more than happy to discuss :)\n\n\u003ca href=\"graphs/contributors\"\u003e\u003cimg src=\"https://opencollective.com/jbot/contributors.svg?width=890\" /\u003e\u003c/a\u003e\n\n## Sponsors\n\nSupport this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://x.com/rampatra_)]\n\n\u003ctable border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://presentifyapp.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://presentifyapp.com/assets/img/presentify/app-icon-512.png\" width=\"150\" height=\"150\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://facescreenapp.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/user-attachments/assets/b251b413-ccc4-48f1-a316-c2c2a71f959e\" width=\"150\" height=\"150\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n        \u003ca href=\"https://todobarapp.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://todobarapp.com/assets/img/todobar/app-icon-512.png\" width=\"150\" height=\"150\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://simplefillapp.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/user-attachments/assets/6c575d9c-b65b-4ce7-a468-30f74cfedf18\" width=\"150\" height=\"150\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n \u003c/table\u003e\n\n---\n\n_P.S. For any queries or concerns, you can reach out to me on [Twitter](https://twitter.com/rampatra_). I'll try my best to help 🙏._\n","funding_links":["https://patreon.com/rampatra","https://opencollective.com/jbot","https://ko-fi.com/rampatra","https://www.paypal.me/iamrampatra"],"categories":["Projects","Java","项目"],"sub_categories":["Miscellaneous","杂项"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frampatra%2Fjbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frampatra%2Fjbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frampatra%2Fjbot/lists"}