Example: Set Up a HiredScore Job Requisition is Filled or Closed Template

This example illustrates:

How to configure the template for the Requisition is Filled or Closed message that is triggered by the Hiring Manager Talent Advisor Collaborator (also known as HMTAC or the HM-TA Collaborator) functionality in Microsoft Teams.

The impact of this configuration in MS Teams.

Your organization uses the HMTAC functionality to facilitate team communication about specific requisitions. It triggers the sending of messages in MS Teams at various stages throughout the process. You want to customize the Requisition is Filled or Closed message template, which notifies the hiring manager and recruiter that a job requisition has been filled or closed. It also informs them that the associated HMTAC channel for the requisition will be archived or deleted as a result. Customization needs to include:

A specific message title.

A tag that mentions and notifies the manager and recruiter that handle the requisition.

A specific message body.

Whether MS Teams should delete or archive the HMTAC channel, and the number of days after filling or closing that this must happen.

After configuration is complete, the message should display as follows in MS Teams:

Your implementer must complete the steps to configure and authenticate the HiredScore and MS Teams integrations in Workday.

Changes submitted on this tab impact your account's configuration in HiredScore and existing configurations (including custom rules or filters) are overridden. Changes can take up to 30 minutes to display in the HiredScore UI. In some cases, this may take longer.

Access the

HiredScore Tenant Setup

task in Workday.

On the

HM <> TA Collaborator

tab, select the

Requisition Filled or Closed Template

sub-tab.

Click

Edit

Select the

Enable in HM-TA Collaborator

check box to ensure that any changes you make on this task are effective in MS Teams after submitting them in Workday.

In the

Triggered By

section, select the

Triggered by Job Requisition Status

that triggers the sending of this message. For the purposes of this example, select

Closed

and

Filled

Enter and select these values in the

Archive or Delete Channels

section:

Field	Value
Days to Deletion/Archival	10
Retention Option	Delete

Enter and select these values in the next section:

Field	Value
Message Title	Req is filled or closed
Mentioning	Manager Recruiter

Customize the template’s

Message Body

Copy the default text in the

Message Body

field.

This field is automatically populated with a default message in JSON format.

Access the Microsoft Adaptive Cards Designer at https://adaptivecards.io/designer/.

In the Adaptive Cards Designer, replace any existing content in the

Card Payload Editor

with the JSON text that you copied in step a.

The card preview updates in real time to display how the message card is currently configured.

In the

Card Payload Editor

, you can customize the message using the parameters listed in the Available Params as well as custom links. For the purpose of this example, include these parameters:

${channel_removal_option}

${value}

The resulting JSON text in the

Card Payload Editor

is:

{
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1",
    "body": [
        {
            "type": "TextBlock",
            "wrap": true,
            "text": "Please note: This Teams channel will be ${channel_removal_option} in ${value} days after the req is closed or filled."
        }
    ]
}

The

version

JSON key is for internal reference purposes only and doesn’t impact JSON behaviour.

Click

Copy Card Payload

and return to the

HiredScore Tenant Setup

task in Workday.

Paste the copied JSON text into the

Message Body

field to replace the existing content.

(Optional) You can include up to 3 link parameters in your message body to direct users to specific URLs. In the

Custom Links

section, enter a URL in the Links field and paste the corresponding Param (Example:

${archived_channel_message_1}

) into the message.

Verify that the JSON syntax is correct to avoid JSON errors.

Click

Done

(Optional) You can add translations for supported languages by selecting

Add Translation

in the

Translations

section.

Select the language you want to add and provide the translated text for both the

Message Title

and

Message Body

fields.

Verify that any dynamic parameters in the original message are maintained in all translations.

After you add translations, verify that the message renders correctly in the Adaptive Cards Designer and that all parameters and links are correct.

When a requisition is closed or filled and the HMTAC functionality triggers an automated MS Teams message to the hiring manager and recruiter, it should display as illustrated in the screengrab:

Any users selected in the

Mentioning

field receive an MS Teams notification.