This Slack bot will allow users to set up notifications "on published" changes to specified Contentful entries and assets to a designated Slack channel.

• Slack Privileages to integrate Incoming Webhooks
• Node.js
• Contentful Access to add outgoing hooks

Allow for incoming hooks to your team's Slack

Deploy the server to your own Heroku instance, and set SLACK_WEBHOOK to the incoming hook url from the integration above

It's preferred to set your locale, and leave your bot's emojis and username blank as these can be edit through the "Incoming Hooks" page by other team members.

The configuration of the bot are set with environment variables using an .env file. Please look at the example.env file of possible configurations, and create an updated .env file before you deploy.

Available Configuration Options:

Here's an example, of how your .env would look like. .env

SLACK_WEBHOOK = https://hooks.slack.com/services/TA123ka9/A123910a9d8/mkas929199sad83lmk7h
SLACK_CHANNEL = #ContentfulFeed
ENTRIES = 6OFbybzxM4WOCuIO4qo8Qs,6aFz3qcuPe0eA8kwQm0Ume,6a232jal2eA8kwQm0Ume,etc
LOCALE = en-UK
PORT = 5000
UPDATE_COLOR = #27ae60
BOT_USERNAME = ContentfulUpdates
BOT_EMOJI = bomb
LARGE_PREVIEW = true

1. Set up the address of your server to configure where Contentful outgoing hooks should be sent to. (ex: myapp.heroku.com, botcontentful.mycompany.com)
2. Clone or download/unzip this repo to your serer
3. Adjust your .env file as outlined above
4. Install Node.js on your server if not done so already
5. Install repo dependencies

$ cd to/repo
$ npm install

6. Start the server

$ npm start

1. Go to Contentful.
2. Login with your credentials.
3. Locate the cog icon labeled settings, and click on 'webhooks'.
4. Hit 'New Webhook', and enter your server address in the URL bar.
5. Click 'Create Webhook'.

After your app has deployed, go to your server url and go to the /check endpoint to verify your settings, and help with debugging any potential issues.

Example:

http://myherokuapp.heroku.com/check

If you've successfully deployed, you should get a successful message stating Successful Set-up along with a table of configurations to verify against as depicted below.

If set up was unsuccessful, you should get a message to verify your configurations, along with important configurations that the server has set up.

If you would like to contribute to this project, take a look at the wiki to get started.

Feel free fork and submit PRs, if applicable reference the issue, or explain the intent of the PR. If it's suitable, I'll go ahead and merge it.