EuropeanJournalismCentre/Sourcebot

An open source newsbot to help African news organisations deliver personalized news and engage more effectively via messaging platforms. # Sourcebot An open source Facebook Messenger news bot for your Wordpress website To help African news organisations deliver personalized news and engage more effectively via messaging platforms. - Develop - Test - Build - Deploy - Run - Contribute - Notes ## Sourcebot version 1.X ## Develop ### Requirements - A Facebook Page - A Facebook App with the Facebook Messenger product - PHP 7.1+ - Xdebug - Composer - A local web-server e.g. Apache - A publicly accessible URL e.g. ngrok - A Wordpress instance with the Wordpress REST API ### First time - Run `composer install` - Visit localhost to confirm you see `index.php` - Run `cp .env.example .env` - Edit `.env` - Run `phpunit` - Run `ngrok http 80` to get the publicly accessible URL - Go to your Facebook App - Click `Webhooks` - Select `Page` from the drop-down - Click `Subscribe to this topic` - Enter the publicly accessible URL of your app and `/webhook.php` - Enter the `FACEBOOK_VERIFY_TOKEN` - Click `Verify and Save` - Visit Facebook Messenger - Search for your Facebook Page and send it a message ## Test Tests are run with `phpunit` ## Build Sourcebot is configured to build on CircleCI. You can run local CircleCI builds with `circleci build` using the CircleCI CLI. ## Deploy ### Sourcebot Setup and Deploy Video Tutorial Here is the full setup process on Medium You can deploy Sourcebot to your own web-server or quickly and for free to Heroku. The latest release of Sourcebot is now supported! Changes include: * Requires PostgresSQL database, available through add-ons: * Heroku-Postgresql (deploy default) * It also requires an instance of Elasticsearch * Bonsai-Elasticsearch (deploy default) * `HEROKU_URL` config var renamed to `PUBLIC_URL` to avoid using Heroku's namespace * `DATABASE_URL` config var will be set for you to access your database ### Things you should know ### Requirements - A Facebook Page - A Facebook App with the Facebook Messenger product - PHP 7.1+ - Composer - A …