How do I forward incidents from Entuity to Microsoft Teams?

To enable incoming webhooks for a Microsoft Teams channel

To forward incidents from Entuity to Microsoft Teams

Introduction:

Incidents can be forwarded to Microsoft Teams using incoming webhooks that expose Teams URLs associated with individual channels.

The affected device plus incident name, severity, status and timestamp can be included in the incident information that is forwarded to the specified Teams channel.

To enable incoming webhooks for a Microsoft Teams channel:

You will need to add incoming webhooks to the desired Teams channel. To do so, please follow these instructions provided by Microsoft.

Once you have set up incoming webhooks, you can copy the webhook URL and then follow the instructions below to forward incidents from Entuity to Teams.

To forward incidents from Entuity to Microsoft Teams:

From the Main Menu, click Administration.
On the Administration page, click Event Administration.
1. If you are using a multi-server configuration and would like to specify a server from which to forward incidents, click View all projects on the Event Administration page.
2. Select your desired server from the Server dropdown field at the top of the page.
3. Select the 'Live' event project from the table and then click Edit at the bottom of the page. This will take you to the Event Administration page
On the Event Administration page, click the Incidents tab. At the bottom of the Incidents tab, click Edit Global Triggers.
Within the Edit Global Triggers dialog, click Add.
Within the Create Trigger dialog:
1. Specify the Name as 'Send to Teams'. The enabled box is ticked by default, but you can untick this to disable the trigger if you desire.
2. Enter a Description, e.g. 'Send incidents to Demo 20 Teams Channel'.
3. Specify when the trigger is applied in the On Transition To dropdown field, selecting from one of the following:
  - Any Change - when you want the action to occur whenever there is a change in the incident. This is useful when you want to ensure all incidents are forwarded to a third party.
  - Opened - action is only run once for the incident, when it is first raised.
  - Reopened - action is not run the first time the incident is raised, but it is run each time the incident is subsequently reopened.
  - Opened or Reopened - action is run the first time the incident is raised and each time the incident is subsequently reopened.
  - Closed - action is run each time the incident is closed.
  - Expired - action is run each time the incident is expired.
4. Leave the Condition as None.
5. Specify if and for how long you want a Delay before an action is performed. If you have set Delay to anything other than None, you can specify an additional test before the action steps are run in the State After Delay dropdown field. For example, if Delay is set to 30 minutes and State After Delay is set to Open, then EMS will only run the action steps for an incident that is in an Open state 30 minutes after it was raised. Specify from one of the following:
  - Open.
  - Closed.
  - Expired.
  - Open or Closed.
  - Any.
6. Click Add to add an action step.
  1. Within the Add Action dialog, select Send to Teams from the Type dropdown field (please note that the 'Send to Teams' action type is currently not available out of the box for Entuity, and will need to be enabled via a groovy script. Please see this article for help and information on enabling this action type in Entuity). Select the path parameter in the Parameters field and click Set.
  2. In the Parameter Value field, enter the webhook URL of the Teams channel (by which notifications are to be sent to Teams), and click OK.
7. Click OK to save your trigger.