{"id":16537903,"url":"https://github.com/multicatch/papajbot-messenger","last_synced_at":"2025-10-07T03:04:49.190Z","repository":{"id":137900796,"uuid":"321687835","full_name":"multicatch/Papajbot-messenger","owner":"multicatch","description":"A simple Facebook messenger chatbot","archived":false,"fork":false,"pushed_at":"2020-12-15T14:12:59.000Z","size":2544,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-27T15:05:43.279Z","etag":null,"topics":["facebook-chatbot","messenger-api"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/multicatch.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-12-15T14:12:30.000Z","updated_at":"2021-04-22T09:36:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"7591073e-e71b-4987-abeb-6cc4f4ca8a0a","html_url":"https://github.com/multicatch/Papajbot-messenger","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/multicatch/Papajbot-messenger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multicatch%2FPapajbot-messenger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multicatch%2FPapajbot-messenger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multicatch%2FPapajbot-messenger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multicatch%2FPapajbot-messenger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/multicatch","download_url":"https://codeload.github.com/multicatch/Papajbot-messenger/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multicatch%2FPapajbot-messenger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278712717,"owners_count":26032742,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["facebook-chatbot","messenger-api"],"created_at":"2024-10-11T18:43:56.891Z","updated_at":"2025-10-07T03:04:44.180Z","avatar_url":"https://github.com/multicatch.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Papajbot Messenger\n\nA Messenger chatbot project written in Kotlin. \nThis project was primarily used for (now dead) Facebook page, but you can use it to build your own chatbot.\n\nThis project does not contain any NLP or ML code. \nIt is a framework used to communicate with Messenger API and respond to messages and user actions.\n\n## Project structure\n\nThis project contains following Maven modules:\n\nThe most important and generic modules:\n* `papajbot-web` - a module that is the glue and also contains the configuration of the chatbot.\n* `papajbot-server-core` - a core module used to run a web server so the Messenger API can communicate with the bot and send messages.\n* `papajbot-model` - the communication model for Messenger API.\n* `papajbot-talk` - a module with base models for human-bot interaction.\n\nThe more specific use-case modules:\n* `papajbot-youtube` - used to respond with a random YouTube video from a given youtube dump file (default is [`youtube_dump.json`](papajbot-youtube/src/main/resources/youtube_dump.json), which contains saved search results with YouTube API).\n* `papajbot-video-responses` - a module with predefined video responses that will be randomly sent when a certain user message is detected.\n\n## Running it\n\nYou can run it like a standard Java app. The `papajbot-web` builds two jars: one standard runnable jar and one with all dependencies packaged.\nTo run it as standalone app please use the second one.\n\nTo test the bot you will need to configure all variables from [Main.kt](papajbot-web/src/main/kotlin/io/github/multicatch/papajbot/Main.kt).\n\nThose include variables with Facebook page access token, webhook response and SSL config.\n\n## Configuration\n\nYou can see the example project configuration in the [Main.kt](papajbot-web/src/main/kotlin/io/github/multicatch/papajbot/Main.kt) file.\nYou can create your own chatbot configuration basing on the one in the `papajbot-web` module.\n\nYou will need to:\n* get a Facebook page access token\n* configure webhook for Messenger API (along with the whole server)\n* configure HTTP client to send configuration to the Messenger API\n* configure possible responding strategy\n\nFor some basics on how a Facebook chatbot works, see [this official guide](https://developers.facebook.com/docs/messenger-platform/getting-started/quick-start/).\n\nPlease note that in the above mentioned file there is a list variable named `handlers` \nthat is used to configure all handlers for responding.\n\nThis is a chain of handlers and when Facebook sends an event, the first matching handler will be used.\n\n## License\n\nAll code stored here is licensed under MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmulticatch%2Fpapajbot-messenger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmulticatch%2Fpapajbot-messenger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmulticatch%2Fpapajbot-messenger/lists"}