This is a simple bot for slack that runs on Beep Boop HQ (Slack's bot hosting platform) integrating with Toggl to run some simple reporting and monitoring tasks:
- Reminds user that they have failed to meet the minumum hours in a period.
- Provide a rolling period summary for any user in slack connected to toggl
You will need the following environment variables for this bot to run.
SLACK_TOKEN=
SLACK_CHANNEL_NAME=
SLACK_NOTIFICATION_LIMIT_PERIOD=
SLACK_TOGGLE_BOT_TEST=false
TOGGL_API_TOKEN=
TOGGL_WORKSPACE_NAME=
USER_MIN_HOURS=
USER_MIN_HOURS_IN_DAYS=
USER_MIN_HOURS_CHECK_FREQUENCY= SLACK_TOKEN
Slack API Token Provided Here: https://[YOUR_SLACK_TEAM].slack.com/apps/new/
SLACK_CHANNEL_NAME
Default slack channel for which the bot will post notifications (e.g. time-management)
SLACK_NOTIFICATION_LIMIT_PERIOD
How often the bot can send a notification for a particular user in hours (e.g. 24)
SLACK_TOGGLE_BOT_TEST=false
set to false unless executing unit tests
TOGGL_API_TOKEN
Toggl API Token Provided Here: https://www.toggl.com/app/profile
TOGGL_WORKSPACE_NAME
Toggl Workspace Name to use (e.g. SlackTogglRemindersWorkspace)
USER_MIN_HOURS
Minimum number hours needed to be recorded in a period (e.g. 40)
USER_MIN_HOURS_IN_DAYS
Number of days in the rolling period (e.g. 7)
USER_MIN_HOURS_CHECK_FREQUENCY
How often to check toggl for time tracking in miliseconds (e.g. 60000)