Docs
WebsiteLoginFree Trial
  • Getting Started
    • OnCall Users
    • Team Admins
    • Account Admins
  • Architecture Guide
  • Common UI Design Patterns
  • Alerts
  • Teams
  • Schedules
  • Escalation Policies
  • Integrations
  • Broadcasts
  • Users
  • Notifications
  • Reports
  • Billing
  • Accounts
  • Stakeholders
  • Maintenance Windows
  • Routers
  • Notification Rules
  • Single Sign On (SSO)
  • Integration Guides
    • Introduction
    • 66uptime
    • Apex Ping
    • AppDynamics
    • Auvik
    • AWS CloudWatch
    • Azure Monitor
    • Cloudflare
    • Cronitor
    • Datadog
    • Dead Man's Snitch
    • Echoes HQ
    • ElastAlert
    • Email
    • Form
    • Freshdesk
    • Freshservice
    • Google Hangouts Chat
    • Grafana
    • Healthchecks.io
    • HetrixTools
    • Honeybadger
    • Hydrozen
    • Jira Server
    • JotForm
    • Kapacitor
    • LogicMonitor
    • Mattermost
      • Outgoing Webhook
      • Post to Channel
    • Meta Workplace
    • Microsoft Teams
    • New Relic
    • Outgoing Webhook
    • Pingdom
    • Prometheus
    • PRTG Network Monitor
    • Pulsetic
    • Sentry
    • ServerGuard24
    • Site24x7
    • Slack
      • Notifications
      • Outgoing Webhook
      • Post to Channel
    • SolarWinds
    • Stackdriver
    • StatusCake
    • Twilio
      • Incoming SMS
      • Live Call Routing
    • Typeform
    • Uptime
    • Uptime Kuma
    • UptimeRobot
    • Webhook
    • Zendesk
  • API
    • Introduction
    • Authentication
    • Errors
    • Pagination and Filters
    • Common Model Attributes
    • Account Users
    • Alerts
    • Broadcasts
    • Comments
    • Escalation Policies
    • Events
    • Integrations
    • Logs
    • Maintenance Windows
    • Notification Rules
    • Routers
    • Schedules
    • Teams
    • Users
  • Command Line Interface (CLI)
    • PagerTree CLI: Command Line Interface
Powered by GitBook
On this page
  • What is a Team?
  • Tutorial Video
  • Team Roles
  • On-Call Schedule
  • Escalation Policy
  • Advanced Options
  • Stakeholder Notifications
  • Drop Notifications
  • Handoff Notifications
  • Public Team Calendar
  • ICal URL
  • Google Calendar
  • Outlook Calendar
  • iCal (Mac) Calendar
  • Special Notes Regarding 3rd Parties Importing Calendars

Was this helpful?

Teams

PreviousAlertsNextSchedules

Last updated 1 year ago

Was this helpful?

What is a Team?

Teams represent actual teams within your organization. They logically group together:

The following are true about teams:

  • must always have at least 1 team member and 1 team admin (even if they are the same account user). See below.

  • always has an active on-call schedule (even if no one is scheduled on-call).

  • always has an active escalation policy with at least 1 layer

Tutorial Video

Team Roles

There are 2 roles regarding teams:

  1. Team Admin

    • Ability to manage the team (add remove other team admins or members).

    • Ability to schedule members on-call.

    • Ability to change the team's escalation policy.

    • Not to be confused with global admin.

  2. Team Member

    • No special roles.

    • Team members show up in the event attendees dropdown when creating on-call events for this team.

On-Call Schedule

The team's on-call schedule determines who is on-call for this team at any given moment.

Escalation Policy

The team's escalation policy defines how alerts will move through the team's on-call schedule.

Advanced Options

  1. Navigate to the Team Edit page.

  2. Click the Show advanced options button.

  3. You will then see the advanced options appear.

Stakeholder Notifications

A team can have team stakeholders. Subsequently every alert that is assigned to this team will also automatically attach the stakeholders to the alert. Stakeholders will then receive notifications about the alert for the events that they have opted in to.

Drop Notifications

A team can elect to have "drop notifications" sent out when an alert that was assigned to this team is "dropped".

Drop notifications can be sent to any of the following:

  • None - No one is notified (default) .

  • Entire Team - The entire team is notified.

  • Team Admins - Only team admins are notified.

  • Current On-Call Rotation - The current on-call rotation (all layers) ar notified. (Warning: if no one is on-call, no one will be notified)

  • Specific Users - Account users that can be selected.

Handoff Notifications

A team can elect to have "handoff notifications" sent out when an alert that was handed off to this team.

Handoff notifications can be sent to any of the following:

  • None - No one is notified (default) .

  • Entire Team - The entire team is notified.

  • Team Admins - Only team admins are notified.

  • Current On-Call Rotation - The current on-call rotation (all layers) ar notified. (Warning: if no one is on-call, no one will be notified)

  • Specific Users - Account users that can be selected.

Public Team Calendar

Public calendars can let you expose a team's on-call calendar (and additional user info) to the public internet. By default all team's calendars are private. Once enabled, the public team calendar url can be found at the top of team page (next to the IDs)

Enable Public Team Calendar

  1. Navigate to the Team Edit page.

  2. Click the "Share Publicly" checkbox.

  3. Additionally you can select the following options:

    • Password - A password that is required to access the public team calendar

    • Share team members - Should team members be shown?

    • Show user phones - Should user phone numbers be shared?

    • Show user emails - Should user emails be shared?

    • Show team schedule - Should the team's on-call schedule be shared?

    • Show escalation policy - Should the team's escalation policy be shared?

Example Public Team Calendar

Annotation #
Option

1

Team Members

2

User phones & emails

3

Team Schedule

4

Team Escalation Policy

ICal URL

For any of the below instructions, you'll need to copy the ICal URL from the PagerTree Team page.

Google Calendar

  1. Select the From URL option.

  2. Paste the PagerTree ICal URL you copied earlier into the "From URL" input field and then click ADD CALENDAR.

  3. Click the back arrow button.

Outlook Calendar

  1. Paste the PagerTree ICal URL you copied earlier into the "New Internet Calendar Subscription" input field and then click OK.

iCal (Mac) Calendar

  1. Paste the PagerTree ICal URL you copied earlier into the "Calendar URL" input field and then click Subscribe.

Special Notes Regarding 3rd Parties Importing Calendars

Third party applications poll the PagerTree servers for new data usually every 1 hour or so. However, we have seen some tools take as long as 1 day.

Please be patient! You will not see your changes from PagerTree immediately. This behavior is the result of the polling mechanism of the third party tools. PagerTree cannot do anything about this.

If you absolutely need the third party updated immediately you can try removing the calendar and re-importing. Take note that some third party tools cache urls, so even if you re-import you could be seeing a stale calendar.

Please see the for full details.

Please see the for full details.

Options for , , and can be configured under the "Advanced Options" of the team form.

See for full details on the functionality.

PagerTree offers the ability to export on-call calendars via iCalendar (.ics) format via a URL. This allows you to see who is on-call via your , , or .

In , from the left hand navigation bar, click the + button next to the "Add a coworker's calendar".

From the Calendar Ribbon, click Add Calendar -> From Internet...

From the menu bar, click File -> New Calendar Subscription...

Configure the Auto-refresh to Every hour then click OK.

schedules documentation
escalation policies documentation
stakeholders documentation
Google Calendar
stakeholder notifications
drop notification
handoff notifications
Google Calendar
Outlook Calendar
iCal (Mac) Calendar
Account Users
Schedules
Escalation Policies
Alerts
team roles section
from url
settings button
PagerTree Teams Tutorial Video (v4)
High Level Alert Workflow (Team)
On-Call Schedule
Escalation Policy
Show advanced options button.
Advanced Options
Public Team Calendar URL
Annotated Public Team Calendar
ICal URL
High level alert workflow
oncall schedule
escalation policy
show advanced option button
advanced options
public team calendar url
annotated public team calendar
Ical url
add calendar
Pagertree Ical URL
Configure AUto Refesh
New internet calendar
Pagertree Ical url
Click New Calendar Subscription
Click Add Calendar From Internet