Job Runner

Post Message to Microsoft Teams

Summary

Post a message to a Microsoft Teams team.

How to Use

Beforehand, set up the Incoming Webhook connector in the team settings of Microsoft Teams for the destination channel.

Parameter

Set Webhook URL, Title, Message, and Mentions.

Webhook URL

Specify the URL created with the Incoming Webhook connector of Microsoft Teams.

Please note that this is not the URL created from the Job Runner’s Kintone Webhook customization.

Title

Set a title for the message. This parameter is optional.

Message

Enter a message to send to Microsoft Teams. This message will be displayed as a chat message in Microsoft Teams.

When using an expression, use ${expression}.

This message must be written using a special notation called markdown, according to the specifications of Microsoft Teams. If it is a short sentence, using ordinary text without knowing the notation is OK. However, you must be careful if you want to insert a line break. In markdown notation, line breaks are removed and converted to spaces.

Even if you break the line in the middle of a sentence or paragraph like this,
chat messages will be displayed continuously without line breaks.
By leaving a blank line and then breaking the line,

line breaks will also occur in chat messages.

Mentions

Use this parameter to include any mentions (destinations) in the message. If a mention is not necessary, it is optional.

When specifying, separate the ID and display name with a comma. When mentioning multiple people, specify one person per line. You can use ${expression}.

There are two ways to specify the ID.

  • User Principal Name (UPN)
  • Microsoft Entra (formerly Azure Active Directory) object ID

For users belonging to a normal organization, the UPN is basically the Microsoft 365 email address. You must be careful when mentioning users who are guests on the team. For guests, the UPN will not be an email address, but will take the form of something like “xxxx_r3it.com#EXT#@yyyy.onmicrosoft.com”. Check the actual UPN in Microsoft Entra.

The specified mentions will be set at the beginning of the message, even if it is not embedded in the body of the message.

Example: Specify 2 people by email address ID

xxxx@r3it.com, John
yyyy@r3it.com, Jane

Example: Specify the ID with the object ID.

c1234567-aaaa-bbbb-cccc-123123123123, Administrator

Example: When the field contains an ID and a display name

${UserID}, ${UserName}

Restrictions

  • You cannot include a comma in the display name of a mention.