You can use placeholders throughout Senta to automatically fill in personalised details when sending emails, notifications and text messages.


So instead of having to send individual messages, you can send customised messages as part of an automatic Job or a bulk email, like this: 


Dear {to.firstname}, 


This makes it really easy to deliver a very personalised service to your clients, with very little effort on your part. 



Where you can use placeholders


You can use placeholders in:

  • Emails set up as part of a Job
  • Notifications set up in a Job
  • Text messages (SMS) set up as part of a Job
  • Bulk emails you send via the client lists 


You can also use placeholders to alter Jobs and Tasks: 

  • Task descriptions 
  • Task titles 
  • Job titles 


Placeholders you can use


You can use many placeholders; the following are especially useful: 


From the 'contacts' tab:


{to.firstname} 

{to.lastname} 

{to.email}


From the 'client' tabs:


{client.title} 

{job.pivotaldate}


From the sender for emails/text messages:


{from.firstname} 

{from.lastname} 

{from.email} 

{from.phone} 


From jobs:


{job.pivotaldate}


For letters or emails, you might like to use the today placeholder: 


    {today}

    {today | D MMMM YYYY}


For emails to your clients about documents, tasks, etc, there is also the following special placeholder that will show the aggregated number of items that are waiting.


    {count} 


Fallback placeholders


You can use "fallback" placeholders, for example {to.nickname/to.firstname} will use the first value if it's available, or the second one if not.


Fallback placeholders can be used in chains, e.g. {to.nickname/to.firstname/to.somethingelse} .


You can also use put "literal" placeholders in using quotation marks e.g. {to.nickname/to.firstname/"Esteemed customer"} .


Client fields 


You can also use any field from the CRM as a placeholder. This means any field on any form! 


For example: 


{client.address1} 

{client.vatnumber} 

etc. 


This gives you a great deal of flexibility to personalise messages from Senta. 


You can also use this for information that has been entered when setting clients up with Services, e.g. during VAT setup or payroll setup. If it's visible on the client tabs, then you use 


{client.something} 


Key dates and other Job fields 


If you define a key date in a Job, you can use the name of the key date as a placeholder. For example, suppose you have a VAT Job and in the Job you define a key date "VAT return due" and you give it a name of "vatreturndue". 


You can then use that as a placeholder: 


{job.vatreturndue} 


This means that you can produce very clear messages that refer to specific deadlines, e.g. tax payment dates and so on: 


You must submit your return by {job.vatreturndue} 


You can also use form fields from Jobs too. 


So, for example, if you have a repeating Job that asks you to fill in a form, you can use values from the form in your emails. You can refer to the field by its internal field name as a placeholder like this: 


The amount you need to pay is {job.payeamount}. 


Please remember however, for data that you've previously captured, i.e. not in this Job, then you need to refer to it like this: 


Your payroll reference is {client.accountsofficereference}. 


If it's visible on a Job tab, then it's 


{job.something} 


Finding the field reference 


To find out the field reference for a field, just go to Settings > Forms and click on the form where the field is. You will find the field reference shown against the field. 


To find out the field reference for a key date, go to Settings > Jobs and click on the Job in question. You will find a field reference against each key date that is set up. 



Formatting placeholders


You can change the way placeholders are displayed by adding special formatting codes to the placeholders, like this: 


{client.address1 | optional} = This placeholder is optional and there won't be an error if it doesn't exist 

{client.address1 | newline} = This placeholder might be blank. If it's not, put a newline after it. 


This is very handy for addresses: 


{client.address1 | newline}{client.address2 | newline}{client.address3 | newline}{client.address4 | newline} 


This would output as many lines of address as there are, with each on a new line. 


Date formatting


Dates have an extra special feature available in email bodies -- you can output them in different formats when you use them, like this:


{client.mydate | DD/MM/YYYY} 


Using the | character, followed by a date format code, tells Senta to format the date in a particular way: 


For 1st February 2017


{client.mydate | D} = 1 

{client.mydate | DD} = 01 

{client.mydate | Do} = 1st

{client.mydate | dd} = We

{client.mydate | ddd} = Wed

{client.mydate | dddd} = Wednesday

{client.mydate | MM} = 02

{client.mydate | Mo} = 2nd

{client.mydate | MMM } = Feb 

{client.mydate | MMMM } = February 

{client.mydate | YY} = 17

{client.mydate | YYYY} = 2017 

{client.mydate | D/M} = 1/2

{client.mydate | DD/MM} = 01/02

{client.mydate | DD-MM-YY} = 01-02-17 

{client.mydate | D MMMM YYYY} = 1 February 2017

{client.mydate | w} = 5 (n.b. this is a week number)

{client.mydate | wo} = 5th

{client.mydate | Q} = 1 (n.b. this is a quarter number)

{client.mydate | Qo} = 1st


Arithmetic in placeholders


You can perform arithmetic in placeholders too.  For example: 


    {(client.monthlyFees * 12) + client.annualFees}


Functions in placeholders


One of the most powerful features of placeholders is support for Excel-like functions, e.g. IF and FIXED.  You can use functions to perform powerful operations in your placeholders.  


For example, some notification email placeholders use a syntax which means that the wording of the email can vary depending on e.g. how many tasks have been assigned to the client.


You can find out more about functions on the functions page


Example


If you assign 1 task to a client, they will receive an email with the subject line "1 new task has been assigned to you..."

If you assign 3 tasks to a client before sending the notification email from your outbox, they will receive an email with the subject line "3 new tasks have been assigned to you..."


This uses the IF function, in much the same way that Excel does, using the format


    {if(clause, option1, option2)}


If "clause" is true, option1 will be used. If not, option2 will be used.


So in the email below:


    {count} new task {if(count>1, "s")} {if(count=1, "has","have")} been assigned to you


becomes


    1 new task has been assigned to you...

    3 new tasks have been assigned to you...