Client contact roles are a way for you to assign tasks to different client contacts according to what they do.
Many clients will have only one contact, which is fine if that contact can deal with everything you give them. But some clients might have more than one point of contact... each with specific roles. For example, you may find that your clients have a primary contact for most interactions with you, but also have a person who deals just with payroll, say.
We can use the email task as an example; usually, Senta will send emails or assign tasks to the client's primary contact, that is, the first contact listed on the client's Contacts tab. But Senta can also send or assign them to someone more appropriate, by using contact roles.
You define a number of roles that the client's contact might have: payroll, management accounts, billing, etc. and then tell Senta which emails or tasks should go to which types of client contact.
Once you've done that, it's just a question of making sure that your contacts have the correct roles ticked. Senta will take of everything else: sending emails and assigning tasks to the right people at the right time.
TABLE OF CONTENTS
Setting up roles
The are two steps to setting up roles on your Senta site. The first is to add roles to your contact form. This will give you the actual roles to tick for your contacts.
Then, you'll edit Jobs to make use of the roles. Once you've added the roles, you can now send emails to contacts with a particular role.
Step 1: Setting up the contact form
Go to Settings > Forms > Edit contact to access the contact form. We recommend adding a Roles tab that will hold the various role tick boxes. Once you've done that, it's a simple matter of adding a new field for each role you want.
Click Add field to add the role.
For each field, you'll need to add a Field description (e.g. Payroll contact) and to set the Field type to "Client role". You might like to add a tooltip (e.g. "Tick if this contact deals with payroll").
You can add as many roles as you like.
Click Save when you're done, to save your form
Step 2: Using the roles in Jobs
Go to Settings > Jobs and choose the Job in question. For example, suppose you've set up a "Payroll contact" role and now want to send an email to the payroll contacts. Click on the "Payroll" Job.
Go to the Tasks tab to see all the Tasks that are in this Job.
In our standard Jobs, the first Task is to send an email to the client asking about payroll changes. Click the Task to expand it.
The email recipient is normally set to "Client primary contact". Click on this drop down and instead choose your new role: "Client Payroll contact".
Now you can click Save. If you have existing payroll Jobs, Senta will ask you if you wish to update them. From now on, that email will go not to the primary contact, but to the payroll contact.
Similarly, if you want to assign a fill in a form task according to client contact role, all you need to do is locate the task in the job template, then select the assignee from the "Assign task to" drop down.
Using roles day-to-day
All you need to do is make sure that individuals have the correct roles ticked on the "Contacts" tab. You will need to edit the client to update the contacts.
If a contact with a required role isn't available, Senta will mark the Task as uncompletable. For example, if your Job needed to send an email to the payroll contact... and you haven't ticked the payroll role for any contact, the Task would be marked as uncompletable.
Referencing in placeholders
If you have provided a field reference for your created role, you can use this within a placeholder. We will use the example of the Payroll role from above which has the field reference payrollrole.
To use this in a placeholder, I will use the client prefix, followed by the client contact role field reference (payrollrole), followed by the field reference from a field from the Contact details form. Here are some examples:
We're going to be extending this feature soon, so you'll be able to use the contact roles to do extra things:
- restricting document access to contacts with certain roles