Starred is expert in continuous feedback in general and for recruitment flows. You can automatically send invitations to candidates or contacts to fill-in specific feedback forms. The feedback results can be seen in Starred using filters and dashboards.

Activation

Only for administrators. If you don't have the fieldset 'Starred' yet, it needs to be activated for you first. Please contact your accountmanager.

  1. To activate open 'Settings', locate Starred section and hit [Activate] button.
  2. After Activation is finished, fill in API key and Company ID.
    To get API key and Company ID values please log into your Starred account and go to https://www.starred.com/api  
  3. [Save]

Functional flow

According to the configuration, you can use 'type of meeting' and 'type of task' to schedule the invites for the feedback. Feedback can be sent to candidates related to the task or meeting. So when you create a meeting with the configured type, a configurable amount of days later the candidate receives an email with an invitation to fill in a feedback document. Mail and document can be edited in Starred as you wish.

When submitted by the candidate, the feedback will be available in Starred

Configuration

You can track 'type of meeting' and 'type of task'. Just add a special tracking code in the corresponding data node 'Code' field. The tracking code always has the following structure:

starred:$CARERIXFLOWNAME:$ACTIVITY_PERIOD:$STARREDFORMID:$STARREDFROMEMAIL:$STARREDTEMPLATEID:$STARREDLANGUAGE

 if there is an existing code for another feature, please use ";" to separate them

Tracking code explained

Carerix options

  • CARERIXFLOWNAME = used to indicate the flow name to activate different behavior. For now only 'candidate' flow is supported.
  • ACTIVITY_PERIOD = a negative value to indicate for how many days to collect activities, e.g -1, -2, -20. Starred invites are collected and sent out at 11:00NL every day including weekends. For example, if you specified period -7 days and Starred invites are being processed on 2017-05-31 at 11:00 then it will collect invites from this period 2017-05-24 00:00:00 to 2017-05-24 23:59:59.

NOTE: 0 is not supported. For non-supported values default '-1' will be used.

Starred options

To get the following values please log into your Starred account and go to https://www.starred.com/api 

  • STARREDFORMID - choose the form you want.
  • STARREDFROMEMAIL - choose the collegue / emailaddress to send the mail from
  • STARREDTEMPLATEID - choose the invitation email template
  • STARREDLANGUAGE - choose the language. supported values nl, en, de, es, fr, it, pt and others. For a complete list see Starred API screen.

STARREDFROMEMAIL - supports 3 formats. Important: Email address must be registered in Starred otherwise, your invites will not be sent.
a) static email - registered email address in Starred, e.g. andrey@carerix.com
b) variable email - will calculate sender email based on related records in your activity. Works with business email address only.
Possible values (include the "{}"):

  • {CandidateOwner}
  • {MatchOwner}
  • {PlacementOwner}
  • {ActivityOwner}
    NOTE: Only one from the list can be specified.

c) variable email with fallback - same as above but will use specified fallback if the sender email is not found .
Possible values (include the "{}"):

  • {CandidateOwner,fallback@company.com}
  • {MatchOwner,fallback@company.com}
  • {PlacementOwner,fallback@company.com}
  • {ActivityOwner,fallback@company.com}
    NOTE: Only one from the list can be specified. only one fallback email can be specified.

Starred invitation template must exist in this language. If it doesn't the whole invite batch will fail.

On the right side the API URL is displayed. You need the info from the url for your code. E.g. the url:

https://api.starred.com/sendinginvitations?company=xmg5cxvlz&auth=digh7&form=8&from=info@carerix.com&template=1&language=en

which contains:

  • $STARREDFORMID: 'form=8'
  • $STARREDFROMEMAIL: 'from=info@example.com'
  • $STARREDTEMPLATEID: 'template=1'
  • $STARREDLANGUAGE: 'en'

leads to the Starred-part of the code:

8:info@example.com:1:en

Which leads to the entire code:

starred:candidate:-2;8:info@carerix.com:1:en

Deactivation

Temporarily disable tracking for a specific type of activity
If you want to temporarily suspend the tracking or you are waiting for production go just add 'starred-off' at the beginning (e.g. starred-off:candidate:...) of a tracking code and save it.

Permanently disable tracking for a specific type of activity
Just remove the whole tracking code from data node and save it.

Disable tracking for all activities
Apply the above option for all types of activities you have configured previously. Alternatively you can disable Starred functionality completely from your Settings screen.

Viewing invites and responses in Starred

The invites and responses are visible in your Starred account. Around midnight types of activities with starred tracking code will be collected and converted into Starred invites. To view the invites 

1) log into your Starred account and go to https://www.starred.com/forms/overview

2) locate the invite form
3) click on 'arrow down' icon and select 'Invitations' 

4) to view a list of invitees click on a row

5) If an invitee has clicked and submitted the feedback it will be available in "Responses" tab 

6) To view the custom data that is available for each invitee click "View feedback" then click on "Details weergeven"

Did this answer your question?