Example: Set Up a HiredScore Provide Interview Feedback Template

This example illustrates:

How to configure the template for the Provide Interview Feedback 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 Provide Interview Feedback message template, which notifies the hiring manager that they completed a candidate interview and prompts them to submit their feedback. They receive a Provide Interview Feedback message for each candidate who completes an interview. Customization needs to include:

A specific message title.

A specific message body that includes the name of the candidate interviewed.

A tag that mentions and notifies the hiring manager that handles the requisition and needs to provide feedback.

A link to the feedback form.

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. They must also set up the Candidate Interview Feedback object 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

Provide Interview Feedback

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, use the

Scheduling Tool Enabled

prompt to select the mechanism that triggers the Provide Interview Feedback message:

Yes - Paradox/Workday Scheduling

Automatically triggers the message after the scheduled interview date and time.

No Scheduling Tool - Job Application Steps

Job application steps (as part of the Hiring Manager Dashboard phase) trigger the message.

For the purposes of this example, select the

No Scheduling Tool - Job Application Steps

option.

Select the

Job Application Steps

for the Hiring Manager Dashboard phases to determine the hiring manager steps that trigger the

Message to Hiring Manager

action.

Enter and select these values:

Field	Value
Message Title	It’s time to provide your interview feedback!
Mentioning	Hiring Manager

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, customize the message using the parameters listed in the

Available Params

section on the

HiredScore Tenant Setup

task. You also have the option of using custom links (see step g
). For the purpose of this example, include these parameters:

${candidate_name}

${wd_candidate_feedback_tab}

The

${wd_candidate_feedback_tab}

parameter directs the hiring manager to the interview feedback form for the candidate in the Workday UI. Only customers that have already set up the feedback form (see the Prerequisites section) can use this parameter.

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": "Your interview with **${candidate_name}** is now complete. Please submit your feedback using this [feedback form.](${wd_candidate_feedback_tab})"
        }
    ]
}

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) In the

Custom Links

section, you can create links that you can also add the message.

Enter a URL (such as the URL of a Help Center article) in the

Links

field.

Copy and paste the corresponding parameter (Example:

${interview_completed_channel_1}

into the message template. Example:

Click [Understand process & responsibilities.](${interview_completed_channel_1})

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.

Following the completion of a candidate interview, the hiring manager receives an automated MS Teams message. When they click the feedback form link in the notification, it brings them directly to the Interview Feedback task for a candidate in Workday. The notification should display as illustrated in the screengrab:

Any users selected in the

Mentioning

field receive an MS Teams notification.