Microsoft Teams

Microsoft Teams is the central meeting place for many organizations and DevOps teams for code reviews, incident notifications, and more. The Scalr Teams integration enables you to be more efficient and move at a faster pace, and at Scalr, we believe in meeting our users where they work. The integration for Teams will send notifications based on run events. The integration can be added through Microsoft AppSource.

Setup

After adding the Scalr app to your team from the Teams Store, start by linking your Teams user to an authenticated user in Scalr by issuing the @scalr connect command. This is required to manage the channel's notification subscriptions.

The following commands can be used in Microsoft Teams to configure the integration:

Command	Description
@scalr connect	Connect your Teams user to the Scalr user
@scalr disconnect	Remove the association with the Scalr account
@scalr subscribe events[, ...] environments[, ...] workspaces[, ...]	Subscribe current channel to select events. 'environments' and 'workspaces' arguments define the Scalr environments and workspaces which the events will stream from
@scalr unsubscribe	Remove the channel's subscription
@scalr help	Display this help message

At least one event and one environment must be supplied to the subscribe command. Adding the environment means that the channel will receive notifications for all the runs from that environment. Workspaces can be specified to narrow down notifications to only runs in the given workspaces (the workspaces must belong to the environments supplied in the environments block).

The integrations:manage permission is needed in Scalr to execute the @scalr subscribe command as it creates a new Teams connection.

Events

Possible events are:

Event	Description
run_approval_required	The run is awaiting for a user to approve it
run_success	The run has finished successfully (this includes canceled/discarded runs)
dry_run_success	The dry run (plan-only) has finished successfully
run_errored	The run has failed
dry_run_errored	The dry run (plan-only) has failed

Examples

Receive notifications only for the run_approval_required and run_errored events from the workspaces ws-xxx, ws-yyy in the env-xxx environment:

@scalr subscribe events[run_approval_required, run_errored] environments[env-xxx] workspaces[ws-xxx, ws-yyy]

Receive notifications for all possible run outcomes from the entire env-xxx environment:

@scalr subscribe events[run_approval_required, run_errored, dry_run_errored, run_success, dry_run_success] environments[env-xxx]