Microsoft Teams Integration

Install the certified ilert bot in Microsoft Teams to receive and act on alerts, raise them, and look up who is on-call.

Install the ilert bot in your Microsoft Teams tenant, then configure each capability you need. The bot is certified by Microsoft; the scopes it requests are listed under Scope definitions.

Select your use case

Receive and respond to alerts in Microsoft Teams

Post alerts into a channel and act on them there, via the chat app or an incoming webhook.

Create alerts in Microsoft Teams

Use Microsoft Teams as an alert source and let Teams users raise alerts.

Look up who is on-call

Check who is on-call for an alert source or escalation policy from any channel.

Start a conference bridge

Use the Teams connector to create a meeting for an incident, so responders can join a live call.

Certification

Our bot has undergone a rigorous certification process by Microsoft, ensuring it meets the high standards for security, privacy, and compliance set forth by Microsoft. This attestation confirms that our app adheres to best practices in software development and data handling.

For a deeper understanding of what certification means and why it matters, please refer to the Microsoft Certification Documentation for third-party apps and services.

Scope definitions

Below is a list and description of each scope used by our bot:

1. Calendars.ReadWrite

• Description: Allows the bot to create, read, update, and delete events in user calendars.
• Use Case: Lets ilert create the Microsoft Teams meeting behind an incident conference bridge. The meeting is created on the calendar of the person who starts the bridge.

2. Channel.Create

• Description: Enables the bot to create new channels.
• Use Case: Create an incident channel when an incident is declared, or from the incident view.

3. Channel.ReadBasic.All

• Description: Grants the ability to read basic properties of channels, including names and descriptions.
• Use Case: This scope is commonly used to allow the bot to provide a summary of available channels or guide users to the right channel.

4. ChannelMember.Read.All

• Description: Allows reading the list of members in each channel.
• Use Case: Necessary for bot that actions based on channel membership e.g. alert acknowledgment.

5. ChannelMember.ReadWrite.All

• Description: Allows the bot to add or remove members from channels.
• Use Case: Necessary for the bot to add the responders working an incident to its incident channel.

6. Chat.Create

• Description: Permits the bot to create one-on-one or group chats.
• Use Case: Enable bots to initiate conversations based on alert actions.

7. Directory.Read.All

• Description: Allows reading data in your organization's directory, such as users, groups, and apps.
• Use Case: Required for the bot to get basic information about a user who is active in ilert and Microsoft Teams, and then combine those activities together.

8. Group.ReadWrite.All

• Description: Enables the bot to read and modify groups, including creating new groups or updating group settings.
• Use Case: Enables the bot to show information about groups in ilert management UI

9. Team.ReadBasic.All

• Description: Provides access to read basic properties of teams, such as team name and description.
• Use Case: Enables the bot to show information about teams in ilert management UI

10. User.Read.All

• Description: Allows reading basic profiles of all users in your organization.
• Use Case: Required for the bot to get basic information about a user who is active in ilert and Microsoft Teams, and then combine those activities together.

The use of these scopes ensures that our bot can interact effectively with Microsoft Teams and its users, providing functionalities that enhance productivity and collaboration within the platform. The scopes are managed carefully to balance functionality with security and privacy concerns.