Introduction to the Microsoft TeamsSyncPack

Download this manual as a PDF file 

This section describes how you can use the "Microsoft Teams" SyncPack to automatically create channels and trigger event messages from Skylar One to Microsoft Teams. The integration is bi-directional between Skylar One and Microsoft Teams. Teams users can interact with Skylar One events directly from the Microsoft Teams interface.

For example, you can acknowledge, and add a note from Microsoft Teams which will be reflected in the Skylar One platform in real time. If you acknowledge an event that appears in Skylar One from Skylar One, and not from Teams, then the sync would be uni-directional and the event would not display in Teams.

This SyncPack uses the "Microsoft Teams Automations" PowerPack.

What Can I Do with this SyncPack?

The Microsoft Teams SyncPack is designed to streamline and automate communication between Skylar One and Microsoft Teams, allowing teams to respond to Skylar One events in real-time. This SyncPack enables the automated creation of Teams channels and messages based on specific Skylar One events, fostering quick and effective collaboration around critical incidents and events.

The SyncPack provides a bidirectional integration between Skylar One and Microsoft Teams, ensuring that updates can flow both ways. This means Skylar One can trigger events in Microsoft Teams, while users can interact with Skylar One events directly from Teams to provide a seamless experience for monitoring and responding to incidents.

You can configure this SyncPack to perform the following integrations:

  • Create a channel in Microsoft Teams to post event notifications from Skylar One.
  • Synchronize an event update made in Microsoft Teams with the event status in Skylar One.
  • Synchronize other event activities and status changes between teams and Skylar One.
  • Add notes in Microsoft Teams that will display in Skylar One from the event acknowledgement.

For more information about how to configure these applications, see Configuring Applications for the Microsoft Teams SyncPack.

Contents of the Microsoft Teams SyncPack

This section lists the contents of the "Microsoft Teams" SyncPack.

Skylar Automation Applications

  • Create Channel For Event. This application sends event notifications to Microsoft Teams by sending an event to a new channel with the event name, or to an already existing channel. The adaptive card in Microsoft Teams includes action buttons for handling the event, as well as the following fields:

    • Event URL. Hyperlink to the event in Skylar One.

    • Event ID. Unique identifier for the event.

    • Device ID. Identifier of the device associated with the event.

    • Device Name. Name of the device associated with the event.

    • Event Severity. Severity level of the event.

    • Event Severity Label. Label describing the severity level.

    • Event Message. Detailed message describing the event.

    • Last Detected. Timestamp of when the event was last detected.

    • First Detected. Timestamp of when the event was first detected.

  • Sync Event Status From Teams to Skylar One. This application synchronizes event updates between Microsoft Teams and Skylar One. The application retrieves the event status from the Teams Application and delivers the same status to Skylar One.

For more information about how to configure these applications, see Configuring Applications for the Microsoft Teams SyncPack.

Configuration Object

  • Sample Microsoft Teams Config. This configuration object can be used as a template after the SyncPack is installed on the Skylar Automation (formerly PowerFlow) system. The configuration object includes the following:
  • Details for connecting to the Skylar One API, including the URL, username, and password
  • Details for connecting to the Microsoft Teams API, including the base URL, private instance URL, and API keys
  • Details for connecting to an HTTP Proxy when communicating with Microsoft Teams, including the hostname or IP address, username, and password
  • Mapping between Skylar One events and Microsoft Teams alerts including, device ID format, heartbeat and schedule name, default user, and maintenance object format information

Steps

The following steps are included in this SyncPack:

  • Create Teams Channel
  • Create Skylar One Payload
  • Resolve Event From Skylar One
  • Fetch Channel ID From Name
  • Fetch Microsoft Email
  • Fetch Teams User Input Data
  • Post Event Card To Teams
  • Post Event Details To Channel
  • Post Update to Skylar One

Contents of the Microsoft Teams Automation PowerPack

This section lists the contents of the "Microsoft Teams Automations" PowerPack, including run book automation policies as well as actions you can use to automate adding, updating, and clearing events, and to automate creating Microsoft Teams channels in Skylar One:

Run Book Automation Policies

  • Microsoft Teams: Create Channel

  • Microsoft Teams: Created Channel Notification - Acknowledge

  • Microsoft Teams: Created Channel Notification - Clear

Run Book Actions

  • Microsoft Teams: Create Channel

  • Microsoft Teams: Created Channel Notification - Acknowledge

  • Microsoft Teams: Created Channel Notification - Clear

Credentials

  • "Skylar Automation Microsoft Teams" sample credential