Set up notifications to Microsoft Teams

Setting up notifications to a Microsoft Teams team allows you to be quickly informed of any status changes. As a result, all users in the Teams team will be notified automatically.

Setting up a custom incoming webhook in Teams

1. In Microsoft Teams, go to the desired team level, choose Other options(⋯) next to the channel name (top right), then choose Connectors.
2. Search or scroll the list of Connectors to Incoming Webhookthen choose Add.
3. Enter a name for the webhook, upload an image to associate with the webhook data, then choose Create.
4. Copy the webhook to the clipboard and save it. You will need the webhook URL to send information to Microsoft Teams.
5. Choose OK.

Test the webhook with cURL. If the publication is successful, a simple result 1 is displayed by curl.

On macOS or Linux

curl -H 'Content-Type: application/json' -d '{"text": "Hello World"}' 

On Windows 

curl.exe -H "Content-Type:application/json" -d "{'text':'Hello World'}" 

A "Hello World" message should now appear on Teams, in the team containing the Webhook.

Setting up a Teams notification contact in ServiceNav

Go to "Configuration > General" and select "Contacts". Consult the page on the configuration of the contacts or on the configuration of notification contacts if necessary.

Select an existing contact or create one.

In the "General Information" pane of the contact configuration, be sure to enter the webhook URL in the "Teams Webhook URL" box.

Further down, in the three "Unit / Equipment / Service notification properties" sections

• Select the notification options. Check the statuses for which you want to be notified.
• Select the notification period from the "Period" drop-down menu (only for services and equipment).
• Check "Teams" in the "Alert by" drop-down menu.

To go further, you can consult these documents

• Unit Service Notification Policy
• User Services Notification Policy
• Equipment notification policy

Setting up notifications in ServiceNav

In the configuration file of an equipment, service or user service, go to the "Notifications" tab.

For services and equipment :

• Check "yes" in "Enable notifications?
• In the "General configuration" panel, select the notification period and the events to be notified.
• In the "Tier 1 Contact(s) and Contact Group" panel, select the previously configured contact(s) with Teams notifications enabled.

For user services :

• Check "Enabled" in "Notification
• Select the status types to be notified.
• Select the previously configured contact(s) with Teams notification enabled.

Validate. The next status changes will now be notified in the defined Teams team, at the indicated periods.

Teams notification example

Status changes are now notified to the Teams team associated with the ServiceNav contact.