Skip to main content

Microsoft Teams

Receive instant Suger notifications and alerts in your Microsoft teams channels.


Overview

By connecting with the Suger app in your Microsoft Teams, you and your team can receive instant notifications and alerts about important sales & revenue events occurring across all your cloud marketplaces.

Create Integration

In your Suger Console, navigate to the 'Integrations' panel. On this page, you will see the Microsoft Teams integration connection status. Click the Connect button to download the Suger Microsoft Teams app package and copy the Binding Token for future use.

Install Suger Microsoft Teams app

  1. Choose the channel you want to send notifications to, then click the Add a tab button as shown below.
  1. Click Manage your apps.
  1. Click button Upload an app, then choose the Suger Microsoft Teams app package you downloaded.
  1. Click button Add.
  1. Click button Set up.
  1. After the app setup is completed, a new tab named Suger will appear in the channel. Click Suger tab.
  1. In the Suger tab, you can change channel name as you like, and paste the Binding Token you get from Suger console. click Save. Now your channel is bound to Suger console.

Verify Microsoft Teams Integration

After you successfully bind the channel to the Suger console, you will see an integration created on the Suger console.

You need to click the Verify button to ensure the bound channel is working. After you click the Verify button, a verification message will be sent to the bound channel.

Edit Integration

If you have successfully bound multiple channels within Suger, you can specify the channel to which the notification will be sent by default via setting the default channel.

Delete Integration

The Microsoft Teams integration can be deleted like all other integrations. Once the deletion is triggered, all integration info including the access token will be deleted immediately & permanently from Suger. No time window or methods to recover.

warning
  • To completely delete the integration, please uninstall the Suger app from your Microsoft Teams.

Type of Notifications

Each type of Notifications consists of the Entity and Action. There are 2 entity types and 7 action types. They are listed below:

EntityThe type of the entity who can do action is one of:
  • OFFER
  • ENTITLEMENT
ActionThe action performed. Can be one of:
  • CREATE: the entity is created.
  • PENDING_START: the entity ENTITLEMENT is pending to start.
  • CANCEL: the entity is cancelled.
  • PENDING_CANCEL: the entity ENTITLEMENT is pending to be cancelled.
  • SUSPEND: the entity is suspended, it may be reinstated or cancelled in the future.
  • REINSTATE: the entity is reinstated from suspended state.
  • UPDATE: the entity is updated.
  • EXPIRE: the entity OFFER is expired
  • TEST: for testing purpose only.

Here is an example of notification you will receive in your Microsoft Teams channel when a new entitlement is created: