Skip to content

Template variables

A variable is a name in single braces, like {company_name}, that Ochema replaces when the text is sent. Each kind of template has its own list. A name in braces that is not in the list of that kind is refused when you save the template (Unknown variable).

Used by the Inbox, automation rules, sequences, broadcasts and the messages Ochema sends by itself. Written in Recruit > Automations, tab Templates; see Message templates.

Variable Shown as What it becomes
{candidate_name} Candidate name (first name only) The first name of the candidate
{recruiter_first_name} Recruiter first name The first name of the recruiter of the candidate. In the First response text to a candidate with no recruiter: “the recruiting team”
{company_name} Company name The name of your company
{job_title} Job title The title of the job of the application the message is about
{scheduling_link} Scheduling link A new link to the scheduling page, made by Schedule interview, the rule action Send the scheduling link of an interview type and the reschedule invites
{resume_link} Resume application link The link to continue an application left halfway, in the Application reminder email
{interview_time} Interview time Day and time of the interview in the time zone of the candidate, for example Tue, Nov 18, 10:00 AM CST, in the interview messages
{interview_details} Interview details How the interview happens: By phone: we will call you at (555) 123-4567., Video call: ... or In person: ..., with the location detail of the interview type
{full_application_link} Full application link The full application link, made by Send full application and the rule action Send the full application
{portal_link} Driver portal link A link to the candidate area. A new link replaces the one the candidate had
{signing_link} Signing link No feature of Ochema fills it today. The emails that ask someone to sign have a fixed text with their own link
{document_name} Document name The name of the driver file item, in the Document expiring and Document sent back messages
{expiration_date} Expiration date The date the item expires, in the Document expiring messages
{days_left} Days left The number of days until the item expires, in the Document expiring messages

Ochema never sends a message with an empty variable. When the text uses a variable that has no value for this candidate, the message is not sent and shows Not sent: the template needs a value this candidate does not have.

  • The first four come from the records: they are empty when the record lacks the value, for example {recruiter_first_name} for a candidate with no recruiter, or {job_title} for a message about no application.
  • A message you write in the Inbox fills {candidate_name}, {recruiter_first_name}, {company_name}, {job_title} and {portal_link}. Any other variable comes only from the feature that makes it, so a template that uses one is not offered when you write by hand.
  • A broadcast fills only {candidate_name}, {company_name} and {recruiter_first_name}. See Broadcasts.
  • Preview on a template shows the text for one candidate and says when a value is missing.

Written in Recruit > Automations, tab Offer templates. Filled when you select Send offer; see Offers.

Variable Shown as What it becomes
{candidate_name} Candidate name The full name of the candidate
{job_title} Job title The title of the job of the application. For a candidate with no job, the Job title you type in the dialog
{terminal_name} Terminal The Terminal chosen in the dialog, or the terminal of the job
{start_date} Start date The Start date of the dialog
{pay} Pay The Pay of the dialog, as you typed it
{benefits} Benefits The Benefits of the dialog
{expires_on} Offer valid until The last day the candidate can accept, from Valid for (days)
{company_name} Company name The name of your company

A variable with no value blocks the offer: the dialog says Fill in and the names of the fields. An offer sent by the rule action Send an offer from a template cannot fill {start_date}, {pay} or {benefits}, so the action refuses a template that uses them.

Written in Compliance > Document types, tab Contract templates. Filled when the document is sent from the driver file; see Contracts and signing.

Variable Shown as What it becomes
{driver_name} Driver name The name in the record of the driver, or of the candidate while in hiring
{company_name} Company name The name of your company
{start_date} Start date For a hired driver, the start date in People > Directory; for a candidate, the start date of the accepted offer
{terminal_name} Terminal For a hired driver, the terminal in People > Directory; for a candidate, the terminal of the job
{today} Date sent The date the document is sent

A document whose template uses an empty variable is not sent. The message says which one, for example Fill in Start date before sending followed by the name of the template and where to fill it in.