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.


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:

@scalr connectConnect your Teams user to the Scalr user
@scalr disconnectRemove 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 unsubscribeRemove the channel's subscription
@scalr helpDisplay 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.


Possible events are:

run_approval_requiredThe run is awaiting for a user to approve it
run_successThe run has finished successfully (this includes canceled/discarded runs)
dry_run_successThe dry run (plan-only) has finished successfully
run_erroredThe run has failed
dry_run_erroredThe dry run (plan-only) has failed


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]