Much like a mail merge function all messages created within Messenger v5 can be personalised by using ‘tokens’. You can use these tokens in broadcast, open or closed response messages, using SMS, voice, email or letter. You should avoid using tokens when 'tweeting' a message and if a token is used, you should ensure that the Message Frequency is set to 'For Each Student Parent Combination'.
Tokens can be activated by placing your cursor in the message text where you wish the token to appear, then ‘right-click’ to show the list of available tokens.
Click on the preferred choice and it will appear in your message surrounded by two dollar signs. Additional tokens can be added via the source data.
The tokens supported in Mv5 are shown in the table below.
Any tokens relating to a student (4 - 14 below) will only render in an outgoing message if the recipient was set up in the MIS and has a student associated with them; i.e. Staff contacts and contacts saved within the Messenger v5 Address Book will, for example receive a message that says "$StudentName$" as opposed to "Clarissa Abbot".
|Token Name||Token Code||Example||Notes|
|Forename||$Forename$||Dear Joe||Displays the First Name of the recipient|
|Surname||$Surname$||Dear Mr Bloggs||Displays the Surname of the recipient.|
|Name||$Name$||Dear Joe Bloggs||Displays the Full Name of the recipient.|
|Title||$title$||Dear Mrs Bloggs||Displays the Title of the recipient.|
|Salutation||$salutation$||Dear Reverend Bloggs||Displays the Salutation of the recipient as specified in the 'Salutation' field of the MIS.
NB Behaviour of this field varies by MIS and may sometimes resolve to e.g. "Mr and Mrs Bloggs" even though only Mrs Bloggs is the intended recipient.
|Student Forename||$StudentForename$||Mary was late.||Displays the First Name of the Student.|
|Student Surname||$StudentSurname$||Dear Miss/Mr Bloggs||Displays the Surname of the Student.|
|Student Name||$StudentName$||Your daughter, Mary Bloggs, was late.||Displays the Full Name of the Student. Will also display the Student's registration group if the "Show Registration in student names?" option is ticked in Tools > Account Settings (your Groupcall Administrator may need to enable this).|
|StudentReg||$StudentReg$||Class 8A have a class trip next term.||Displays the student’s registration/class group.|
|StudentYear||$StudentYear$||All year 8 students have sports day next week.||Displays the student’s year group.|
|Student Detention Date||$Student Detention Date$||Your son, Mary Bloggs has detention on 17/04/2013. She will be late home.||Displays the date of a student's detention. See Detention Alerting for more information, particularly around the use of this token when selecting 'Once per Parent' from the Message Frequency options.|
|He/Shehe/she||$He|She$$he|she$||She will need to see the head.Remember PE kit for you child tomorrow; he will need it.||Assumes a gender appropriate pronoun based on student gender. Can be capitalised or not to suit the sentence.|
|His/Herhis/her||$His|Her$$his|her$||Her PE kit should be clean.Please make sure your child brings his homework to school.||Assumes a gender appropriate pronoun based on student gender. Can be capitalised or not to suit the sentence.|
|Him/Herhim/her||$Him|Her$$him|her$||---Your child will need PE kit with him tomorrow.||Assumes a gender appropriate pronoun based on student gender. Can be capitalised or not to suit the sentence.|
|Current Date||$date$||Today is the 11/04/2013. The school will be closing early due to snow.||Inserts the current date as defined when the message is sent. When combined with scheduled send, the date changes accordingly.|
|Current Time||$time$||It is now 09:20. Morning registration has taken place and your child $StudentName$ has not registered today. Please provide a reason.||Inserts the current time as defined when the message is sent. When combined with scheduled send, the time changes accordingly.|
|Tomorrow's Date||$tomorrow$||The school will be closed tomorrow 12/04/2013 due to snow.||Inserts the date of the day after today as defined when the message is sent. When combined with scheduled send, the date changes accordingly.|
|Home Address||$homeaddress$||57 Mounthoolie Lane
|Inserts the contact's home address so that a traditional letter can be posted in place of an email.|
|School Logo||$schoollogo$||---||Inserts an image as uploaded in Tools > Account Settings > Contact Details.|
|Head Teacher Name||$headteachername$||Regards,Lawrence Royston, NPQH||Inserts the head's name (including any letters of qualification) as specified in Tools > Account Settings > Contact Details.|
|School Address||$schooladdress$||Main Office
|Inserts the school address as specified in Tools > Account Settings > Contact Details.|
|School Phone||$schoolphone$||Tel: 01234 567 890||Inserts the school phone number as specified in Tools > Account Settings > Contact Details.|
|Unresolved Attendance Dates||$unresolvedattendance$||Tue, 09 June, 2015 to Fri, 12 June, 2015||Inserts a date or list of dates where, in a given period, a student has absences where the reason for absence is not yet provided (such as an 'N' code).
NB this token can not be used manually and will only work where a date range is provided using the Unresolved Attendance Wizard.
Certain other tokens may be enabled in your school based on your particular set-up.