Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dwolla/bambot

BambooHR Slack bot publishes company holidays, work anniversaries, first days, birthdays, and who is out each weekday.
https://github.com/dwolla/bambot

bamboohr bamboohr-api slack slack-bot slackbot

Last synced: 3 months ago
JSON representation

BambooHR Slack bot publishes company holidays, work anniversaries, first days, birthdays, and who is out each weekday.

Awesome Lists containing this project

README

        

# bambot

BambooHR Slack bot that, each weekday, publishes

- Who is out
- Birthdays
- Work anniversaries, including a welcome message on the first day
- Company-observed holidays

Slack screenshot of bambot message

## Setup

- Clone the repository and run `npm install`
- Ensure your [AWS credentials are available](https://serverless.com/framework/docs/providers/aws/guide/credentials/)
- If you have access, generate a [BambooHR API key](https://www.bamboohr.com/api/documentation/) within your account. Otherwise, have a BambooHR admin at your company generate one for you.
- Determine the BambooHR subdomain associated with your company
- Configure a Slack [Incoming Webhook](https://slack.com/apps/manage/custom-integrations)
- Deploy with `BAMBOOHR_KEY=YOUR_KEY BAMBOOHR_SUBDOMAIN=YOUR_SUBDOMAIN SLACK_WEBHOOK_URL=YOUR_URL npm run deploy`. It will run Mon-Fri at 7 a.m. UTC, you can adjust this schedule in `serverless.yml`.

## Developing

- Run tests, `npm test`
- Invoke locally, `npm run invoke`