Send Microsoft Teams message

Prerequisites: This workflow item is only available via consultation with your account manager. Please talk to your account manager if you would like to have this activated for your organisation. For this workflow item to work, you need to give Automation various permissions to post in your Teams instance. Learning Pool will walk you through this process. 

Send Microsoft Teams message sends a message to a Team channel or an individual user on behalf of an admin user. We suggest that you set your admin account up with a profile picture and name that indicate that it is a bot and only use the admin account for sending messages from Automation

 

Configuring the item

Identifier	The identifier dictates where a message should be posted in your Teams instance. Teams user email -The email address associated with the user's Teams account. Ideally this will be the same email address associated with the user's LXP account or LRS persona. If you use this, a message will be sent directly to the user. Teams user ID - If you have obtained the user ID via API, or already have it recorded in a custom field in the LXP (click here to read more) you can use the user's unique ID to send a message directly to them.  Channel - To post to a public channel, right click on the channel and select Get link to channel:
Importance	Normal - sends a standard message:  High - sends a message flagged as important: Urgent - sends a message flagged as urgent:
Text	Text can be formatted using the formatting tools in the workflow item.

Clickable links for variables

Note: This information is specific to MS Teams to ensure the link is clickable. For other messaging workflows, such as Slack, the URL variable can be put directly in the editor.

The link functionality can be used to add clickable links that direct the user to the appropriate course without manual editing.

• In the workflow item, click Link icon (4th Icon from the options)

• Then this dialog will appear
• On the display text - if you want to use a variable as a placeholder, just add curly brackets like so {VARIABLE_NAME}
• Change protocol to other
• Add curly brackets along with variable placeholder to the url field like so {TriggerObjectUrl}

The backend will replace variable placeholder with its value:

Adding images

• Edit your Send MS Teams Message workflow item.

• Click show additional options.

• Look for the field titled attachments.

• The attachments are expected to be in array format:

 

[
  {
    "contentUrl": <Image_url>,
    "position": <"top" or "bottom">,
    "alt": <String value>
  }
]

contentUrlis the direct link to your image. This link to be accessible to the recipients.

position has two options, top or bottom which will position the image above or below the text.

alt specifies an alternate text for an image for screen readers or other accessibility aids. The text should describe the image if the image contains information.

 

Example:

[
  {
    "contentUrl": https://learningpool.com/hubfs/Learning%20Pool%20Primary%20Logo.svg,
    "position": "top",
    "alt": "Banner logo for Learning Pool"
  }
]