Introduction to the Microsoft TeamsSyncPack

 

This section describes how you can use the "Microsoft Teams" SyncPack to automatically create channels and trigger event messages from SL1 to Microsoft Teams. The integration is bi-directional between SL1 and Microsoft Teams. Teams users can interact with SL1 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 SL1 platform in real time. If you acknowledge an event that appears in SL1 from SL1, 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 SL1 and Microsoft Teams, allowing teams to respond to SL1 events in real-time. This SyncPack enables the automated creation of Teams channels and messages based on specific SL1 events, fostering quick and effective collaboration around critical incidents and events.

The SyncPack provides a bidirectional integration between SL1 and Microsoft Teams, ensuring that updates can flow both ways. This means SL1 can trigger events in Microsoft Teams, while users can interact with SL1 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 SL1.
• Synchronize an event update made in Microsoft Teams with the event status in SL1.
• Synchronize other event activities and status changes between teams and SL1.
• Add notes in Microsoft Teams that will display in SL1 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.

PowerFlow 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 SL1.

  • 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 SL1. This application synchronizes event updates between Microsoft Teams and SL1. The application retrieves the event status from the Teams Application and delivers the same status to SL1.

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 PowerFlow system. The configuration object includes the following:

• Details for connecting to the SL1 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 SL1 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 SL1 Payload
• Resolve Event From SL1
• 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 SL1

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 SL1:

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

• "PowerFlow Microsoft Teams" sample credential