OnCallManager Documentation: Setup Guide for Slack
Learn how to set up and manage on-call rotations in Slack using OnCallManager. This guide covers installation, creating rotations, managing schedules, and integrating with Google Calendar.
Getting Started
Step 1: Install OnCallManager
- Click the "Add to Slack" button
- Review the permissions and authorize the app for your workspace
- Once installed, find OnCallManager in your Slack apps
Step 2: Access the App Home
Open Slack and click on "OnCallManager" in your apps list. The app home is where you'll create and manage all your on-call rotations.
Creating and Managing Rotations
Creating a New Rotation
- Click "New Schedule" on the app's home page
- Enter a name for your rotation (e.g., "Backend On-Call")
- Select the team members to include in the rotation
- Choose the rotation frequency (daily, weekly, etc.)
- Set the start date and time for shifts
- Optionally select a notification channel
- Preview the schedule and click "Create"
Editing or Deleting Rotations
To modify an existing rotation:
- Find the rotation on the app home page
- Click the overflow menu (three dots)
- Select "Edit" to modify settings or "Delete" to remove
Overriding Shifts
When team members need to swap shifts:
- Open the rotation's overflow menu
- Select "Override on-call"
- Choose the shifts you want to override
- Select the replacement team member
- Click "Apply" to confirm
Learn more about managing fair rotations in our rotation scheduling guide.
Google Calendar Integration
Sync your on-call schedule with Google Calendar to see your shifts alongside your other appointments.
Connecting Your Calendar
- Click "Connect Calendar" on the app home page
- Sign in to your Google account when prompted
- Grant OnCallManager permission to create calendar events
Subscribing to Rotations
- Open a rotation's overflow menu
- Select "Subscribe to Calendar"
- Your shifts will automatically appear in Google Calendar
Note: When you disconnect your calendar, all calendar events created by OnCallManager will be automatically removed.
Notifications & Group Updates
Automatic Group Updates
OnCallManager automatically updates the Slack user group associated with your rotation when shifts change. This ensures that @mentioning your on-call group always reaches the current on-call person.
Channel Notifications
If you've set a notification channel for your rotation:
- A message is sent when a new rotation is created
- Shift change notifications are posted when the on-call person changes
- Override notifications announce temporary coverage changes
For tips on handling incidents effectively, see our incident response guide.
Need More Help?
Have questions not covered here? We're happy to help.