Configuring Teams chat messages to Teamwork templates

Last updated on 2021-11-10 • 2 min read

Summary¶

With Teamwork it it possible to provisioning chat messages to Microsoft Teams channels. Provisioning chat messages requires service account with Teams license in use and the messages will appear in Teams posted by service account.

Chat message from onboarding

Configure chat messages to templates¶

Teams channel messages are configured inside elements. Please see following example from HR Onboarding template:

  <Teams>
    <Channels>
      <Channel Name="General" Description="HR Onboarding template" IsFavorite="true" RemoveWikiTab="true">
        <Messages>
          <Message Subject="🌞 Welcome to your Onboarding Hub! 🌞">
            <Extensions />
            <Body ContentType="text">In this group you can chat with your supervisor, mentor and HR. We thought this might be a safe space for you to ask questions to ask anything that's on your mind. In addition, you will find all the other people and public conversations in our public company team. Have a lovely work day and let's keep in touch!</Body>
          </Message>
        </Messages>

Here follow the available child elements for the Message element.

Element	Type	Description
Body	MessageBody	Defines the message’s body

Here follow the available attributes for the Message element.

Attribute	Type	Description	Required	Default
Subject	xsd:string	Defines the subject of the chat message, in plaintext	Yes
Importance	xsd:string	Defines the importance of the chat message. The possible values are: normal, high and urgent	Yes	normal
Summary	xsd:string	Defines the summary text of the chat message that could be used for push notifications and summary views or fall back views	Yes

Here follow the available child elements for the Body element.

Element	Type	Description
Content	xsd:string	Defines the plaintext/HTML representation of the content of the chat message

Here follow the available attributes for the Message element.

Attribute	Type	Description	Required	Default
ContentType	xsd:string	Defines the type of the content. Possible value is: text	Yes

Please see the Configuring Teamwork templates, to learn more about what configurations are supported for Teamwork templates.