{"id":20832490,"url":"https://github.com/codetanzania/facebook-majifix-bot","last_synced_at":"2025-12-11T17:02:48.322Z","repository":{"id":91615481,"uuid":"117987481","full_name":"CodeTanzania/facebook-majifix-bot","owner":"CodeTanzania","description":null,"archived":false,"fork":false,"pushed_at":"2018-01-26T11:33:01.000Z","size":99,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-12T08:35:12.072Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodeTanzania.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-01-18T13:37:08.000Z","updated_at":"2018-01-18T13:38:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"b7292a1a-13e7-414f-bb1b-426fbcde21e3","html_url":"https://github.com/CodeTanzania/facebook-majifix-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CodeTanzania/facebook-majifix-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeTanzania%2Ffacebook-majifix-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeTanzania%2Ffacebook-majifix-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeTanzania%2Ffacebook-majifix-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeTanzania%2Ffacebook-majifix-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodeTanzania","download_url":"https://codeload.github.com/CodeTanzania/facebook-majifix-bot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodeTanzania%2Ffacebook-majifix-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27667251,"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-12-11T02:00:11.302Z","response_time":56,"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":[],"created_at":"2024-11-18T00:12:02.165Z","updated_at":"2025-12-11T17:02:48.274Z","avatar_url":"https://github.com/CodeTanzania.png","language":"JavaScript","readme":"# Dawasco Facebook BOT \n- Node \u003e= 7.6\n- [bottender](https://github.com/Yoctol/bottender)\n- Yarn (Dependency Manager)\n- Winston (Logger)\n\nThis is the facebook messenger bot to help many dawasco customers who are using facebook to report water related problems direct to dawasco. \n\nThis BOT is just another channel among many other channels that dawasco use to reach their customers.\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch based on git flow \n3. Commit your changes\n4. Push to the branch\n5. Submit a pull request\n\n## Usage\nTo run this app on any environment you must set the following environmental variable.\n\nVariable | Desc\n--------| -------\nPAGE_ACCESS_TOKEN | Facebook page access token\nAPP_VERIFY_TOKEN | Verify token, this is local created and set in the facebook page\nAPP_ID | Bot App Id as provided by facebook\nAPP_SECRET_TOKEN | Bot secret token\nBASE_API_URL | Base api url e.g `https://dawasco.herokuapp.com/open311/`\n\nNote:\nMake sure you understand basic concept of [bottender](https://github.com/Yoctol/bottender) as that\nwill make your life easy to understand whats going on.\n\n\n## Folder Structure\n\nThe project files are organized as follows;\n\n```\n.\n├── README.md\n├── app\n│   ├── actions.js\n│   ├── api.js\n│   ├── bottender.config.js\n│   ├── handlers\n│   │   ├── changeLocale.js\n│   │   ├── changePhoneNum.js\n│   │   ├── main.js\n│   │   └── submitProblem.js\n│   ├── index.js\n│   ├── locales\n│   │   ├── en.json\n│   │   └── sw.json\n│   └── winston.js\n├── package.json\n└── yarn.lock\n```\n\n\n### app/index.js\n\nAll functionalities start from here.\\\nMainly it's a server which listen on port 5000. You are encouraged to add more [event listener](https://bottender.js.org/docs/APIReference-Event)\nand [handler](https://bottender.js.org/docs/APIReference-Handler) to enrich the bot.\n\n### app/actions.js\nIt contains functions that when executed they send command to user to prompt them to do something with the bot. They stay in this file so that they can be reusable. If action to be sent to user is not expected to be reused\nsomewhere else then we don't recommend to put it here.\n\n### bottender.config.js\n\nThe config file for the bot.\\\nWe suggests you to put all platform configs into this file and use it as a parameter\nof createServer.\n\n## Available Scripts\n\nThere are two default scripts you can run:\n\n### `npm run dev`\n\nRun the bot in the development mode.\\\nIt will automatically restart the bot if there are any changes in `app/index.js`.\\\nFor more information, check [nodemon's repo](https://github.com/remy/nodemon)\n\n### `npm start`\n\nRun the bot without being monitored.\\\nThe bot won't be restarted when you change anything in `app/index.js`\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetanzania%2Ffacebook-majifix-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodetanzania%2Ffacebook-majifix-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodetanzania%2Ffacebook-majifix-bot/lists"}