Microsoft Teams Text Template

Teams Templates are used to create standard format of Teams message that will be sent from the NSP.

The following figure shows the Teams Template form. This form contains the basic fields that are necessary to create the template like Name, Subject, HTML template, Teams notification color and MS Teams Webhook url.

Create Teams Template

Fields in Teams Template form:

   Name: Enter name of the Teams Template. This field contains two controls: textbox and a language dropdown list. You first need to select the language from the dropdown list to create Teams Template for that specific language. You can select different languages and then define Name and body text (HTML Template) for the selected language in respective textbox. Repeat the procedure for next language needed, and so on. User will receive the notification in his default language.

   Text Template: This text box is used to define the body text in HTML text format.

   Preview button is also available here which is used to preview the Teams message text. 

   Tags: Consists of a dropdown list for entity selection and a list of available Tags. You can enter Tags for dynamic fields by selecting appropriate entity and tag in the list. You can drag and drop tags or double click the tag to include it in the template along with other text. These tags will be replaced with the actual value when an message is sent to the Teams channel. Tags could be included in the body text (HTML Template). Tags are grouped according to their types. Following types and respective tags are available in NSP:

o Entity fields: Contains properties of the entity selected in the above dropdown list. If no entity is selected, then it displays general entity fields.

o Comment: Contains tags containing information from the ticket comments (including comment author, public/internal solutions and public/internal workarounds).

o Changes: Contains one tag to include List of Latest Changes (history) of an entity.

o SLA/OLA Agreement: Contains three tags:  SLA/OLA Waypoint Name, SLA/OLA Waypoint Deadline and SLA/OLA Threshold Color.   

o System: Contains tags for Entity Link, Reset Password Link, Create Password Link, Survey Link, Triggers, Now UTC, Day ago UTC, Week ago UTC, Month ago UTC and Year ago UTC.

The Triggers tag is different than the others and described here.

o Attached CI: Contains CI property tags, used for CI linked to the current ticket entity. If more than one CI is linked to the ticket all tags refer first linked CI. It is not possible to refer the other linked CI in the template.

o Template Tags: Contains field codes for System URL, Header, Footer, OTP (one-time password uses this tag to send two-factor authentication code) and Authentication Server URL. These fields are dynamic and values can be defined under Template Tags in System tab of Global Configurations.

   Teams notification color: Here you can choose the indicator color for the bar that will arrive within the Teams channel.

   MS Teams webhook url: Here you need to insert the url from the Teams channel incoming webhook to which you want to receive notifications from the system.

 

When values in all fields are entered, click Save button to create the Teams Template.