Progress Notifications



Progress notifications send information about important Stacktape operations to a specified destination, such as Slack or Microsoft Teams.

By default, notifications are sent for the deploy and delete commands. You will be notified when:

  • An operation starts successfully.
  • An operation finishes successfully.
  • An error occurs.

Slack notifications

To set up Slack notifications, you need to provide:

  • accessToken: A Bot User OAuth Token. You can obtain one by following the first two steps in this Slack guide.
  • conversationId: The ID of a channel, direct message, multi-person direct message, or group. To get the ID of a channel, navigate to the channel, click on its name, and look for the ID at the bottom of the About tab.
progressNotifications:
  - type: slack
    properties:
      conversationId: C#######
      accessToken: xoxb-####################
SlackIntegrationAPI reference
typeRequired
No description

Type: string "slack"

properties.conversationIdRequired

The Slack channel or DM ID to send notifications to.

Type: string

To find the ID: open the channel, click its name, and look at the bottom of the About tab.

properties.accessTokenRequired

Bot User OAuth Token for your Slack app. Store as $Secret() for security.

Type: string

Create a Slack app, add the chat:write scope, install it to your workspace, then copy the Bot User OAuth Token.

Microsoft Teams notifications

To set up Microsoft Teams notifications, you need to provide your webhookUrl. You can obtain one by following this guide.

progressNotifications:
  - type: ms-teams
    properties:
      webhookUrl: C#######
MsTeamsIntegrationAPI reference
typeRequired
No description

Type: string "ms-teams"

properties.webhookUrlRequired

Incoming Webhook URL for the MS Teams channel. Store as $Secret() for security.

Type: string

Create an Incoming Webhook connector in your Teams channel settings to get this URL.