Look up who is on call in Microsoft Teams
Answer "who do I page?" inside Microsoft Teams with @ilert oncall, for an alert source or an escalation policy.
@ilert oncall answers who is on call, in the channel you type it in. The app posts a See who is on-call card; Continue opens the dialog.
There are two ways to set it up:
Restricted
Teams users who also have an ilert account
Nothing beyond connecting the app
Open
Anyone in the team
A Microsoft Teams alert source with the on-call option ticked
Option 1: Restrict to Teams users with an ilert account
Anyone whose ilert username or email address matches their Teams email address can type @ilert oncall in a channel of a team the app is installed in.
The dialog offers Search an alert source and Search an escalation policy, each with its own Search button, over what that person may read in ilert. In a channel that belongs to a Teams alert source, the dialog opens with that source's on-call people already listed, and the search boxes underneath.
Option 2: Let anyone in the team look up who is on call
Useful in a team's own channel: colleagues ask who to page without knowing the name of an escalation policy, and without an ilert account.
Create or open a Microsoft Teams alert source
Follow Create alerts in Microsoft Teams to create one, or open the Microsoft Teams settings tab of an existing Teams alert source. One alert source covers both commands.
Turn the lookup on
Under @ilert oncall command configuration, tick Let Microsoft Teams users without an ilert account see who is on-call using the @ilert oncall command.
This also ticks Include the primary phone number of the user who is on-call in on-call posts. Untick it if the phone numbers of your on-call people should not be shown to everyone in the channel.
Anyone in those channels can now run @ilert oncall and get the list, without a search.
What the answer shows
One block per escalation policy, with the people on call.
Only the first escalation level of each policy. Later levels, and the delays between them, are not shown — the answer is "who gets paged first", not the whole policy.
A user rule shows that user as always on call; a schedule shows the current shift and when it ends; a team rule lists its members.
Phone numbers, where you allowed them.
A footer names the time zone the times are given in.
FAQ
Someone gets "You don't have permission to view current on-call."
They have no ilert account, and the channel's Teams alert source does not allow the open lookup. Tick Let Microsoft Teams users without an ilert account see who is on-call using the @ilert oncall command in that alert source's Microsoft Teams settings.
The dialog says the channel is not configured
That is the answer for someone with an ilert account in a channel that belongs to no Teams alert source. They can still search any alert source or escalation policy they may read. Add the channel to a Teams alert source to get the list without searching.
"Your Microsoft Teams bot has no permission. Please reauthorize the bot."
The connection needs renewing, or the person searched for something they may not read in ilert. Open Settings → Connectors and use Update on the Microsoft Teams card if it is offered, or ⋯ → Re-connect.
Can I hide phone numbers?
Yes. Untick Include the primary phone number of the user who is on-call in on-call posts. People who do have an ilert account still see the numbers.
Last updated
Was this helpful?