TracCloud: Emails: Difference between revisions

From Redrock Wiki

No edit summary
No edit summary
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TracCloudGuideTabs}}
{{TracCloudGuideTabs}}
{| style="width:100%; vertical-align:top; "
<div class="tcWidgetPage">
| style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TracCloudGuideProfileTOC}}
<div class="categoryWide">
| style="vertical-align:top; padding:20px 20px 20px 2px;" |
{{TracCloudGuideProfileTOC}}
{| style="width:100%; vertical-align:top; "
</div>
<big><b>Emails</b></big><br><br>
<big><b>Emails</b></big><br>
There are various Profile-specific emails that can be configured in TracCloud. Most are sent automatically, such as confirmations and reminders, while some are sent manually, like visit notes. This chapter will provide an overview of these email templates, what they do, and how they can be personalized.
There are various Profile-specific emails that can be configured in TracCloud. Most are sent automatically, such as Confirmations and Reminders, while some are sent manually, like Visit Notes. This article will provide an overview of these email types, what they do, and how they can be customized for your use-case.<br><br>


This chapter will only be covering definitions and basic customization of TracCloud emails. For more information on email tags and instructions on utilizing Twig for further control over what information is sent, please take a look at our dedicated Twig article.
''Other > Other Options > Profiles > [Your Profile] > Prefs > Emails''.
<br>
[[File:4225012.png|800px]]
<br><br>
 
References:<br>
 
* <b>Twig</b>
::[[TracCloudGuideProfilePrefsTwig|Twig]] and [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] are used extensively throughout emails. This includes simple elements, like using <nowiki>{{Student.First_Name}}</nowiki> to display a student's first name dynamically, to more advanced logic determining exactly what text is included in each email. This article will be referencing Twig, but will not being going into detail. For more information on this topic, take a look at our dedicated [[TracCloudGuideProfilePrefsTwig|Twig Guide]].
 
::In the top right corner of your 'Emails' menu is an 'Email Tags' list. This provides quick access to all of your available tags for these emails, which can also be clicked and dragged into text fields to populate them automatically.<br><br>
 
* <b>Previewing Emails</b>
::Every email in this menu has a <i>Preview</i> button to see how your email will display when it's sent. It is required to preview emails before saving any changes. The preview will show the most recent record of that time in the system by default, you can specify a different record to use as an example by clicking the "Sequence #" button the preview window.<br><br>
 
* <b>Loading Default Emails</b>
::Most email prefs here offer a default that you can load, either to use as-is or as a template to build off of. Click the clipboard icon next to your email to load the default email format.
 
<hr>
==Select an email type below to learn more.==
 
<hr>
<!-------------------------------------------- Confirmations -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Confirmation Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Confirmation Emails</b> are sent to [[TracCloudGuideListingsStudents|Students]], [[TracCloudGuideProfileStaff|Consultants]], and an optional third address when an [[TracCloudGuideListingsAppts|appointment]] is booked. Consultants and Students can receive unique versions of this email, depending on the information required for either party. You can also decide whether the email is sent the moment the appointment is booked, later in the night, or at a specific time in the morning.
 
[[File:3077721.png|900px]]<br><br>
 
* <b>Send Confirmation Emails</b>
::Disable this email, send immediately upon Appointment being booked, or send in a batch that night or the next morning at a time of your choice.
 
 
* <b>Student/Consultant confirmation email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Student/Consultant confirmation email</b>
::The body of the email to be sent to Students/Consultants.
 
 
* <b>Student/Consultant confirmation SMS Msg</b>
::A separate message sent to the Student/Consultant's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>Attempt Consultant as Reply To Address</b>
::If enabled, TracCloud will try to use the consultant's email address as the reply-to address for the confirmation message to students. This would allow students to reply to the confirmation email with their consultant as the recipient.
 
 
* <b>CC the Profile on Student/Consultant confirmation emails</b>
::This option will send a copy of this email to your Profile email address if available.


''Other > Other Options > Profiles > [Your Profile] > Prefs > Emails''. Here you will see the available emails to modify.
 
<br>
* <b>Send Confirmation to Consultant Also</b>
[[File:9654th5536j346.png|800px]]
::Allows you to independently disable the Consultant confirmation email, if they're more likely to rely on other resources to see their appointments for the day.
 
 
[[File:7970512.png|900px]]<br><br>
 
* <b>Send Additional Email on New Appointment</b>
::This allows you to enable one more Confirmation email to be sent to the email address defined below.
 
 
* <b>Additional confirmation email address</b>
::In the example above, we're using a Custom Field in the student's profile that contains their Assigned Advisor's email address. We can also choose to have a static email address in this field instead.
 
 
* <b>Additional confirmation email subject</b>
::Just like the standard Confirmation emails, we can write out our custom subject line...
 
 
* <b>Additional confirmation email</b>
::...and the email body itself.
 
</div>
<hr>
<!-------------------------------------------- Reminders -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Reminder Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Reminder Emails</b> are sent to [[TracCloudGuideListingsStudents|Students]] and [[TracCloudGuideProfileStaff|Consultants]] to remind them of upcoming [[TracCloudGuideListingsAppts|appointments]]. Just like confirmations, this can be configured separately for students and consultants. You can set the exact time reminder emails are sent each day, either the night before or a custom time in the morning. Reminders can also be disabled for students, consultants, or both.
 
[[File:7699050.png|900px]]<br><br>
 
* <b>Send Reminders Emails</b>
::Disable Reminder emails or choose when reminder emails are sent at the specified time(s).
 
 
* <b>Student/Consultant reminder email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Student/Consultant reminder email</b>
::The body of the email to be sent to Students/Consultants.
 
 
* <b>Student/Consultant reminder SMS Msg</b>
::A separate message sent to the Student/Consultant's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>Attempt Consultant as Reply To Address</b>
::If enabled, TracCloud will try to use the consultant's email address as the reply-to address for the reminder message to students. This would allow students to reply to the reminder email with their consultant as the recipient.
 
 
* <b>CC the Profile on Student/Consultant reminder emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
 
* <b>Send Reminder to Consultant Also</b>
::Allows you to independently disable this email for Consultants. This is typically disabled if you plan to use Consultant Schedule Summary Emails instead.
</div>
<hr>
<!-------------------------------------------- Cancellations -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Cancellation Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Cancellation Emails</b> will be sent to [[TracCloudGuideListingsStudents|Students]] and [[TracCloudGuideProfileStaff|Consultants]] immediately upon [[TracCloudGuideListingsAppts|appointment]] cancellation. Each user-type will receive a unique email with information about the cancelled appointment.
 
[[File:8745743.png|900px]]<br><br>
 
* <b>Send Cancellation Emails</b>
::Enable or disable this email type.
 
 
* <b>Student/Consultant cancellation email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Student/Consultant cancellation email</b>
::The body of the email to be sent to Students/Consultants.
 
 
* <b>Student/Consultant cancellation SMS Msg</b>
::A separate message sent to the Student/Consultant's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on Student/Consultant cancellation emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
</div>
<hr>
<!-------------------------------------------- Missed -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Missed Appointment Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<br><br>
* <b>Confirmation Emails</b> are sent to students and consultants when an appointment is booked. Consultants and students can receive unique versions of this email, depending on the information required on either side. You can also decide whether the email is sent the moment the appointment is booked, later in the night, or at a specific time in the morning. And of course, confirmation emails, and everything else in this article, can be disabled individually by user-type or disabled entirely if it’s not needed.
<b>Missed Appointment Emails</b> are sent to the [[TracCloudGuideListingsStudents|Student]] when an [[TracCloudGuideListingsAppts|Appointment]] is missed. This email can be sent the evening of, or the day after the appointment should've taken place.
 
[[File:1187829.png|900px]]<br><br>
 
* <b>Send Missed Appointment Emails</b>
::Disable, or choose when this email is sent.


* <b>Reminder Emails</b> are sent to students and consultants to remind them of upcoming appointments. Just like confirmations, this can be configured separately for students and consultants. You can set the exact time reminder emails are sent each day, either the night before or a custom time in the morning. Reminders can also be disabled for students, consultants, or both.


* <b>Cancellation Emails</b> will be sent to students and consultants immediately upon appointment cancellation. Each user-type will receive a unique email with information about the cancelled appointment.
* <b>Change missed appointment to Status</b>
::When this process runs, it will automatically change the appointment status if there's no corresponding visit record. This setting determines what status the appointment is set to, which will typically be the same as your Profile 'Status for missed' definition.


* <b>Missed Appointment Emails</b> are sent to the student when an appointment is missed. This email can be sent the evening of, or the day after the appointment should've taken place.


* <b>Consultant Schedule Summary Emails</b> will be sent to consultants the evening before or the morning of their schedule appointments. This single email can contain information about multiple upcoming appointments, rather than receiving individual emails for each appointment.
* <b>within x Minutes before/after appointment time</b>
::A time buffer can be assigned here to determine when an appointment should be counted as 'Missed' if there's a Visit record in close proximity. For example, if a student has a 9:00am Appointment, but they started their Visit at 9:05am, we probably shouldn't mark this Appointment as missed, but if the Student is 25-minutes late, maybe that does qualify as a 'Miss' for your campus. 30-minutes in both fields is what most campuses tend to start with.


* <b>Visit and Visit Duration Notification Emails</b>. Visit reasons can be configured with a “Notify Time Expired” setting. When that time limit is reached, an email can be sent to the center, consultant, or a specific email address automatically. This menu also allows you to configure an email that will be sent out after students conclude their visit.


* <b>Send Visit Notes to Coach, Advisor, or Student</b> can be manually sent to faculty, coaches, or students after a visit takes place, containing visit notes and other information about their visit. The prompt to send this email can appear on the students' individual visit entry pages or during the log-out process.
* <b>Student appointment missed email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.


* <b>Profile Email Address</b> is the address that all emails from this profile will be sent from.


==Customizing Emails==
* <b>Student appointment missed email</b>
Let’s start by customizing our confirmation email as an example. Once you understand how this email works, most of the others will immediately make sense in comparison.
::The body of the email to be sent to Students.
<br>
 
[[File:6k5k64hh4474k54k4.png|800px]]
 
* <b>Student appointment missed SMS Msg</b>
::A separate message sent to the Student's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on Student appointment missed emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
</div>
<hr>
<!-------------------------------------------- Auto Cancel -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Auto Cancellation Emails from Student Cancellations</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Student auto cancellation emails</b> will be sent only if this functionality is enabled. The first two preferences in this menu allow you to define a limit for how many consecutive recurring appointments a student can cancel before TracCloud automatically cancels the entire series.
 
[[File:2579295.png|900px]]
<br><br>
<br><br>
* <b>Send Confirmation Emails:</b>
* <b>Cancel recurring appointments after # consecutive student cancellations</b>
This determines when or if this email gets sent out. Typically, this will be set to "Immediate," so once the appointment is booked, the confirmation emails are already being sent out. However, you may prefer to send them all at once later at night or a custom time the next morning.
::This enables or disables the auto-cancellation functionality for recurring appointments. If this is disabled ("No"), all other preferences in this menu can be ignored.
 
 
* <b>Cancel recurring appointments after how man consecutive cancels</b>
::This is the threshold of consecutive cancellations before the recurring appointment series is automatically cancelled. Default is 2.
 
 
* <b>Student/Consultant auto cancellation email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Student/Consultant auto cancellation email</b>
::The body of the email to be sent to Students/Consultants.
 
 
* <b>Student auto cancellation SMS Msg</b>
::A separate message sent to the Student's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 


* <b>Email Subject and Email Contents</b>
* <b>CC the Profile on Student/Consultant auto cancellation emails</b>
This email can be written out to include anything you can think of, from basic information about the appointment to more in-depth instructions on joining online sessions. This is completely up to you.
::This option will send a copy of this email to your Profile email address if available.


In the email contents, we can include <b>email tags</b> to dynamically pull the data we want to include. For example, if we want to include the student's name in the introduction, we can simply type "Hello, <nowiki>{{Student.First_Name}}</nowiki>," which will automatically pull the student's first name when sent.
</div>
<hr>
<!-------------------------------------------- Auto Miss -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Auto Cancellation Emails from Student Misses</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Student auto cancellation emails</b> will be sent only if this functionality is enabled. The first two preferences in this menu allow you to define a limit for how many consecutive recurring appointments a student can miss before TracCloud automatically cancels the entire series.


To view a list of available tags and easily add them to your email, there's a button above the email settings. When selected, you will be provided a list of tags that can be used. You can even click and drag these tags into the email box to add them to your message. You can hover your mouse over custom field tags to see the corresponding field name, as seen in the screenshot below.
[[File:3240827.png|900px]]
<br>
[[File:Yu654jh52gff235gh.png|800px]]
<br><br>
<br><br>
For more specific Twig instructions and a list of email tags, take a look at our Twig article.
* <b>Cancel recurring appointments after # consecutive student misses</b>
::This enables or disables the auto-cancellation functionality for recurring appointments. If this is disabled ("No"), all other preferences in this menu can be ignored.


* <b>Preview</b>


Each email field also has a Preview button, which allows you to see what the email will look like and make sure that there aren’t any formatting errors. This will need to be selected prior to saving.
* <b>Cancel recurring appointments after how man consecutive misses</b>
::This is the threshold of consecutive misses before the recurring appointment series is automatically cancelled. Default is 2.


==Consultant Schedule Summary==
 
The Schedule Summary will include information about each of the consultant's upcoming appointments. What differentiates this email template from others is that the Schedule Summary is written in three different sections. You can write the opening/top of the email, the repeating text box for appointment information, and the final/closing text.  
* <b>Student/Consultant auto cancellation email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Student/Consultant auto cancellation email</b>
::The body of the email to be sent to Students/Consultants.
 
 
* <b>Student auto cancellation SMS Msg</b>
::A separate message sent to the Student's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on Student/Consultant auto miss cancellation emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
</div>
<hr>
<!-------------------------------------------- Schedule Summary -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Consultant Schedule Summary Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Consultant Schedule Summary Emails</b> will be sent to consultants the evening before or the morning of their schedule appointments. This single email can contain information about multiple upcoming appointments, rather than receiving individual emails for each appointment. You can write the opening/top of the email, the repeating text box for appointment information, and the final/closing text.  
<br>
<br>
[[File:64857bev6u45ef75.png|800px]]
[[File:9332607.png|900px]]
<br><br>
<br><br>
* <b>Send Consultant Schedule Summary Emails</b>
::Disable this email, or send in a batch the night before or the morning of their appointments at a time of your choice.
* <b>Consultant schedule email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
* <b>Consultant schedule email (top section)</b>
* <b>Consultant schedule email (top section)</b>
This text will always be placed at the top of the email, frequently used for greetings or instructions.
::This text will always be placed at the top of the email, frequently used for greetings or instructions.
 
 
* <b>1-on-1 appointment (appointments, repeats)</b>
::This text will repeat for each of their upcoming appointments (the next day, or day of depending on when they're being sent). If the consultant has 4 appointments today/tomorrow, this section will repeat 4 times with information about each one, with the exception of Group Appointments...
 
 
* <b>Group appointments</b>
::Since you probably don't need to repeat the time, subject, center, and so on for each appointment of a group session, you can use this to format those sessions differently than 1-on-1's.
:::* <b>group appointment start (appointments, repeats)</b>
::::Use this to write out the non-student-specific information. Time, Center, Subject, Location, etc. Will display once for each Group Session.
:::* <b>group line</b>
::::Use this to write out the student-specific information. Student name, email address, subject if you're allowing to students to book the same session for different topics. This will repeat for each Appointment within a Group Session.
:::* <b>end of group</b>
::::This concludes the Group Session summary. Typically, a couple line breaks or a horizontal line like in the example above.


* <b>Consultant schedule email (appointments, repeats)</b>
This text will repeat for each of their upcoming appointments (the next day, or day of depending on when they're being sent). If the consultant has 4 appointments today/tomorrow, this section will repeat 4 times with information about each one.


* <b>Consultant schedule email (bottom)</b>
* <b>Consultant schedule email (bottom)</b>
This text will appear at the very bottom of the email, below all appointment information, and won't repeat.
::This text will appear at the very bottom of the email, below all appointment information, and won't repeat.
 
 
* <b>CC the Profile on Consultant schedule reminder emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
</div>
<hr>
<!-------------------------------------------- Visit and Duration -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Visit and Visit Duration Notification Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Visit and Visit Duration Notification Emails</b>. Visit reasons can be configured with a “Notify Time Expired” setting. When that time limit is reached, an email can be sent to the center, consultant, or a specific email address automatically. This menu also allows you to configure an email that will be sent out after students conclude their visit.
 
[[File:8827877.png|900px]]<br><br>
 
 
* <b>Send Visit Duration Notification Emails</b>
::Choose whether or not to send notification emails when the Visit Time limit of a particular Reason is reached. [[TracCloudGuideProfileReasons|More information.]
 
 
* <b>Visit duration notification email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Visit duration notification email</b>
::The body of the email to be sent to your selected users.
 
 
* <b>Send Visit Email after Visit Conclusion</b>
::Choose whether or not an email should be sent when a Student logs out of a Center.
 
 
* <b>Visit email address</b>
::Choose what email address receives this email. This can be a static email address, or dynamic with a Twig Tag as seen above. This can be used to send a summary of a visit to the Student themselves, their Tutor or Assigned Advisor, a Faculty member, or another email address entirely.
 
 
* <b>Visit email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 


==Send Visit Notes to Coach or Advisor==
* <b>Visit email</b>
This email contains information about a specific visit that can be sent to faculty, advisors, or even students. This is typically used if you want to let a faculty member know how a visit went, or if you wanted to forward a copy of the visit information to the student or their advisor. This email type also has some specific tags that aren't available in other emails, "Visit Fields." More information on these tags can be found in our Twig article.
::The body of the email to be sent to Students/Consultants.
<br>
</div>
[[File:35jh34h35hg35jh3.png|800px]]
<hr>
<!-------------------------------------------- Send Notes -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Send Visit Notes to Coach, Advisor or Student</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<br><br>
<b>Send Visit Notes to Coach, Advisor or Student</b> can be used to send visit information to any of the previously named users, or more. The prompt to send this email can appear on individual visit records to be selected by staff, or it can be automatically initiated during visit conclusion. One of the most common uses for this feature is for Consultants to send their Visit Notes (and general Visit information) to faculty.
[[File:2376358.png|900px]]<br><br>
* <b>Activate send notes option on visit entry screen</b>
* <b>Activate send notes option on visit entry screen</b>
If enabled, users with the appropriate permissions will be able to send this email via a button contained within each visit record.
::If enabled, users with the appropriate permissions will be able to send this email via a button contained within each visit record.
[[File:6j64h43h35j36j3.png|450px]]
::[[File:6j64h43h35j36j3.png|500px]]
 


* <b>Activate send notes option on KIOSK visit exit</b>
* <b>Activate send notes option on KIOSK visit exit</b>
If enabled, users with the appropriate permissions will be able to send the email with a checkbox during the log out process.
::If enabled, this email will be sent immediately upon visit logout.
 
 
* <b>Send Visit Notes - Email Subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>To Address of Recipient of the Notes</b>
::This controls which user these emails will be sent to.
::<span style="color:#ff0000"><nowiki>{{Faculty.Email}}</nowiki></span> for Faculty<br>
::<span style="color:#ff0000"><nowiki>{{Student.Email}}</nowiki></span> for Students<br>
::<span style="color:#ff0000"><nowiki>{{Consultant.Email}}</nowiki></span> for Consultants or Advisors<br>
::Static email addresses, [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] pointing to Custom Fields, and semi-colons for multiple email addresses can also be used.
 
 
* <b>'Who' Label of the Button for Sending the Notes</b>
::The label/name of the button, as seen in the “Activate send notes” screenshot.
 
 
* <b>Send Visit Notes email</b>
::The body of the email to be sent to your selected users.
 
</div>
<hr>
<!-------------------------------------------- Resources -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Resource Checkout Emails</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<b>Resource Checkout Emails</b> contains several emails relating to [[TracCloudGuideBasicsResources|resource]] records. Emails can be sent when an item is overdue, upon checkout, prior to the due date, prior to a reservation date, and upon return.
 
<section begin="resources" />
[[File:3583722.png|900px]]<br><br>
 
* <b>Send Overdue Emails</b>
::Disable this email, or choose what time it should be sent. This email will send if a student has an overdue checkout.
 
 
* <b>Student resource overdue email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig Tags]] just like the body of the email.
 
 
* <b>Resource overdue email</b>
::The body of the email to be sent to Students.
 
 
* <b>Resource overdue SMS Msg</b>
::A separate message sent to the Student's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on Resource overdue emails</b>
::This option will send a copy of this email to your Profile email address if available.
 
 
* <b>Send additional overdue emails daily</b>
::Resend the above email on a daily basis until the item is returned.
 
 
* <b>Student resource confirmed subject</b>
::This email is sent immediately upon resource checkout. This option affects the subject line of the email, which supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig tags]] just like the body of the email.
 
 
* <b>Resource confirm email</b>
::The body of the email to be sent to Students.
 
 
* <b>Resource confirm SMS Msg</b>
::A separate message sent to the student's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on confirmation emails</b>
::This option will send a copy of this email to your Profile email address if available.<br><br>
 
[[File:1803308.png|900px]]<br><br>
 
* <b>Send Resource Reminder Emails (Pickup and Return)</b>
::Choose when reservation and overdue reminders are sent. The reservation email will notify the student that an item they reserved is available for pickup based on the first day of their reservation. The return reminder will send prior to the item becoming overdue.
 
 
* <b>Student resource pickup/return reminder email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig tags]] just like the body of the email.
 
 
* <b>Resource pickup/return reminder email</b>
::The body of the email to be sent to Students.
 
 
* <b>Resource pickup/return reminder SMS Msg</b>
::A separate message sent to the Student's phone. Requires [[TracCloudTA|TextAlerts Module.]]<br><br>
 
[[File:5176821.png|900px]]<br><br>
 
* <b>Resource Return Confirmation</b>
::This email allows you to send an email to the user confirming that they have returned the resource.
 
 
* <b>Student resource return confirmation email subject</b>
::The subject line of the email, supports [[TracCloudGuideProfilePrefsTwig#Tag_List|Twig tags]] just like the body of the email.
 
 
* <b>Resource return confirmation email</b>
::The body of the email to be sent to the user.
 
 
* <b>Resource return confirmation SMS Msg</b>
::A separate message sent to the user's phone. Requires [[TracCloudTA|TextAlerts Module.]]
 
 
* <b>CC the Profile on resource return confirmation emails</b>
::This option will send a copy of this email to your Profile email address if available.<br><br>
<section end="resources" />
</div>
<hr>
<!-------------------------------------------- Workshops  -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big>Workshops</big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<section begin="workshops" />
<b>Workshop</b> emails are sent when a student is added to a workshop, removed from a workshop (canceled), and as a reminder the night before or morning of the workshop taking place. These emails can be edited in <i>Other > Other Options > Profiles > [Your profile] > Prefs > Emails > Workshops.</i>
 
[[File:8722555.png|900px]]<br><br>
 
* <b>Workshop enrollment confirmation email subject</b>
::This email sends when a student is enrolled in a workshop. Enter the subject line of the email here, supports [[TracCloudGuideProfilePrefsTwig|Twig]] just like the body below.<br><br>
 
* <b>Workshop confirmation email</b>
::The body of the workshop enrollment confirmation.<br><br>
 
* <b>Workshop enrollment confirmation SMS Msg</b>
::A separate message to be sent to the student's phone. Requires [[TracCloudTA|TextAlerts module]].<br><br>
 
* <b>CC the Profile on workshop enrollment confirmation emails</b>
::This option will send a copy of this email to your Profile email address if available.<br><br>
 
* <b>Workshop enrollment cancellation subject</b>
::This email is sent upon a student's enrollment in a workshop being canceled, supports [[TracCloudGuideProfilePrefsTwig|Twig]] just like the body below.<br><br>
 
* <b>Workshop cancellation email</b>
::The body of the workshop enrollment cancellation.<br><br>
 
* <b>Workshop enrollment cancellation SMS Msg</b>
::A separate message to be sent to the student's phone. Requires [[TracCloudTA|TextAlerts module]].<br><br>
 
* <b>CC the Profile on workshop enrollment cancellation emails</b>
::This option will send a copy of this email to your Profile email address if available.<br><br>
 
* <b>Send Workshop Reminder emails</b>
::You can optionally send a reminder the day before or the morning of a workshop taking place to the student's email address and/or phone number. A specific time must be chosen for this email to send.<br><br>
 
* <b>Upcoming workshop reminder email subject</b>
::The subject like of the workshop reminder email, supports [[TracCloudGuideProfilePrefsTwig|Twig]] just like the body below.<br><br>
 
* <b>Upcoming workshop reminder email</b>
::The body of the workshop reminder email.<br><br>
 
* <b>Upcoming workshop reminder SMS Msg</b>
::A separate message to be sent to the student's phone. Requires [[TracCloudTA|TextAlerts module]].<br><br>
 
* <b>CC the Profile on upcoming workshop reminder emails</b>
::This option will send a copy of this email to your Profile email address if available.
<section end="workshops" />
</div>
<hr>
 
* <b>Profile Email Address</b> is the address that all emails from this profile will be sent from. This is also the address used for "CC the Profile on..." settings.


* <b>On KIOSK Exit, Send Notes button will be checked by default</b>
* <b>Include iCal attachments</b> enables calendar attachments for your emails. These can be added to a user's personal calendar, but this is only a one-way communication.
This controls whether the above option is checked by default or not.


* <b>To Address</b>
<hr>
This controls which user these emails will be sent to.
<big>Other Email Articles</big><br>
Not all of TracCloud's email-related settings are found in your Profile Prefs. Here are some quick links to other email settings:


<span style="color:#ff0000"><nowiki>{{Faculty.Email}}</nowiki></span> for Faculty<br>
<b>[[TracCloud:_Mail_Server|Mail Servers]]</b> - Looking to start using TracCloud's email capabilities, but don't have an email server setup yet? Start here.
<span style="color:#ff0000"><nowiki>{{Student.Email}}</nowiki></span> for Students<br>
<span style="color:#ff0000"><nowiki>{{Consultant.Email}}</nowiki></span> for Consultants or Advisors<br>


* <b>'Who' Label</b>
<b>[[TracCloud:_Email_Templates|Email Templates]]</b> - Write an email as a template, and re-use it as needed when manually sending emails to Students and Staff.
The label/name of the button, as seen in the “Activate send notes” screenshot.


<b>[[TracCloudGuideGlobalNotifications|Notifications]]</b> - Send Notifications to Students, displayed in TracCloud directly or sent over email.


<b>[[TracCloudST|SurveyTrac Module]]</b> - Send Students Surveys over email when their visit concludes, batch send to entire lists, and more.


<b>[[TracCloudTA|TextAlerts Module]]</b> - Send Students and Staff a text message along with their email.


|}
[[Category:TracCloud]]
{{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}}
</div>

Revision as of 12:15, 18 November 2024

Emails
There are various Profile-specific emails that can be configured in TracCloud. Most are sent automatically, such as Confirmations and Reminders, while some are sent manually, like Visit Notes. This article will provide an overview of these email types, what they do, and how they can be customized for your use-case.

Other > Other Options > Profiles > [Your Profile] > Prefs > Emails.
4225012.png

References:

  • Twig
Twig and Twig Tags are used extensively throughout emails. This includes simple elements, like using {{Student.First_Name}} to display a student's first name dynamically, to more advanced logic determining exactly what text is included in each email. This article will be referencing Twig, but will not being going into detail. For more information on this topic, take a look at our dedicated Twig Guide.
In the top right corner of your 'Emails' menu is an 'Email Tags' list. This provides quick access to all of your available tags for these emails, which can also be clicked and dragged into text fields to populate them automatically.

  • Previewing Emails
Every email in this menu has a Preview button to see how your email will display when it's sent. It is required to preview emails before saving any changes. The preview will show the most recent record of that time in the system by default, you can specify a different record to use as an example by clicking the "Sequence #" button the preview window.

  • Loading Default Emails
Most email prefs here offer a default that you can load, either to use as-is or as a template to build off of. Click the clipboard icon next to your email to load the default email format.

Select an email type below to learn more.


Confirmation Emails



Confirmation Emails are sent to Students, Consultants, and an optional third address when an appointment is booked. Consultants and Students can receive unique versions of this email, depending on the information required for either party. You can also decide whether the email is sent the moment the appointment is booked, later in the night, or at a specific time in the morning.

3077721.png

  • Send Confirmation Emails
Disable this email, send immediately upon Appointment being booked, or send in a batch that night or the next morning at a time of your choice.


  • Student/Consultant confirmation email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student/Consultant confirmation email
The body of the email to be sent to Students/Consultants.


  • Student/Consultant confirmation SMS Msg
A separate message sent to the Student/Consultant's phone. Requires TextAlerts Module.


  • Attempt Consultant as Reply To Address
If enabled, TracCloud will try to use the consultant's email address as the reply-to address for the confirmation message to students. This would allow students to reply to the confirmation email with their consultant as the recipient.


  • CC the Profile on Student/Consultant confirmation emails
This option will send a copy of this email to your Profile email address if available.


  • Send Confirmation to Consultant Also
Allows you to independently disable the Consultant confirmation email, if they're more likely to rely on other resources to see their appointments for the day.


7970512.png

  • Send Additional Email on New Appointment
This allows you to enable one more Confirmation email to be sent to the email address defined below.


  • Additional confirmation email address
In the example above, we're using a Custom Field in the student's profile that contains their Assigned Advisor's email address. We can also choose to have a static email address in this field instead.


  • Additional confirmation email subject
Just like the standard Confirmation emails, we can write out our custom subject line...


  • Additional confirmation email
...and the email body itself.

Reminder Emails



Reminder Emails are sent to Students and Consultants to remind them of upcoming appointments. Just like confirmations, this can be configured separately for students and consultants. You can set the exact time reminder emails are sent each day, either the night before or a custom time in the morning. Reminders can also be disabled for students, consultants, or both.

7699050.png

  • Send Reminders Emails
Disable Reminder emails or choose when reminder emails are sent at the specified time(s).


  • Student/Consultant reminder email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student/Consultant reminder email
The body of the email to be sent to Students/Consultants.


  • Student/Consultant reminder SMS Msg
A separate message sent to the Student/Consultant's phone. Requires TextAlerts Module.


  • Attempt Consultant as Reply To Address
If enabled, TracCloud will try to use the consultant's email address as the reply-to address for the reminder message to students. This would allow students to reply to the reminder email with their consultant as the recipient.


  • CC the Profile on Student/Consultant reminder emails
This option will send a copy of this email to your Profile email address if available.


  • Send Reminder to Consultant Also
Allows you to independently disable this email for Consultants. This is typically disabled if you plan to use Consultant Schedule Summary Emails instead.

Cancellation Emails



Cancellation Emails will be sent to Students and Consultants immediately upon appointment cancellation. Each user-type will receive a unique email with information about the cancelled appointment.

8745743.png

  • Send Cancellation Emails
Enable or disable this email type.


  • Student/Consultant cancellation email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student/Consultant cancellation email
The body of the email to be sent to Students/Consultants.


  • Student/Consultant cancellation SMS Msg
A separate message sent to the Student/Consultant's phone. Requires TextAlerts Module.


  • CC the Profile on Student/Consultant cancellation emails
This option will send a copy of this email to your Profile email address if available.

Missed Appointment Emails



Missed Appointment Emails are sent to the Student when an Appointment is missed. This email can be sent the evening of, or the day after the appointment should've taken place.

1187829.png

  • Send Missed Appointment Emails
Disable, or choose when this email is sent.


  • Change missed appointment to Status
When this process runs, it will automatically change the appointment status if there's no corresponding visit record. This setting determines what status the appointment is set to, which will typically be the same as your Profile 'Status for missed' definition.


  • within x Minutes before/after appointment time
A time buffer can be assigned here to determine when an appointment should be counted as 'Missed' if there's a Visit record in close proximity. For example, if a student has a 9:00am Appointment, but they started their Visit at 9:05am, we probably shouldn't mark this Appointment as missed, but if the Student is 25-minutes late, maybe that does qualify as a 'Miss' for your campus. 30-minutes in both fields is what most campuses tend to start with.


  • Student appointment missed email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student appointment missed email
The body of the email to be sent to Students.


  • Student appointment missed SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.


  • CC the Profile on Student appointment missed emails
This option will send a copy of this email to your Profile email address if available.

Auto Cancellation Emails from Student Cancellations



Student auto cancellation emails will be sent only if this functionality is enabled. The first two preferences in this menu allow you to define a limit for how many consecutive recurring appointments a student can cancel before TracCloud automatically cancels the entire series.

2579295.png

  • Cancel recurring appointments after # consecutive student cancellations
This enables or disables the auto-cancellation functionality for recurring appointments. If this is disabled ("No"), all other preferences in this menu can be ignored.


  • Cancel recurring appointments after how man consecutive cancels
This is the threshold of consecutive cancellations before the recurring appointment series is automatically cancelled. Default is 2.


  • Student/Consultant auto cancellation email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student/Consultant auto cancellation email
The body of the email to be sent to Students/Consultants.


  • Student auto cancellation SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.


  • CC the Profile on Student/Consultant auto cancellation emails
This option will send a copy of this email to your Profile email address if available.

Auto Cancellation Emails from Student Misses



Student auto cancellation emails will be sent only if this functionality is enabled. The first two preferences in this menu allow you to define a limit for how many consecutive recurring appointments a student can miss before TracCloud automatically cancels the entire series.

3240827.png

  • Cancel recurring appointments after # consecutive student misses
This enables or disables the auto-cancellation functionality for recurring appointments. If this is disabled ("No"), all other preferences in this menu can be ignored.


  • Cancel recurring appointments after how man consecutive misses
This is the threshold of consecutive misses before the recurring appointment series is automatically cancelled. Default is 2.


  • Student/Consultant auto cancellation email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Student/Consultant auto cancellation email
The body of the email to be sent to Students/Consultants.


  • Student auto cancellation SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.


  • CC the Profile on Student/Consultant auto miss cancellation emails
This option will send a copy of this email to your Profile email address if available.

Consultant Schedule Summary Emails



Consultant Schedule Summary Emails will be sent to consultants the evening before or the morning of their schedule appointments. This single email can contain information about multiple upcoming appointments, rather than receiving individual emails for each appointment. You can write the opening/top of the email, the repeating text box for appointment information, and the final/closing text.
9332607.png

  • Send Consultant Schedule Summary Emails
Disable this email, or send in a batch the night before or the morning of their appointments at a time of your choice.


  • Consultant schedule email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Consultant schedule email (top section)
This text will always be placed at the top of the email, frequently used for greetings or instructions.


  • 1-on-1 appointment (appointments, repeats)
This text will repeat for each of their upcoming appointments (the next day, or day of depending on when they're being sent). If the consultant has 4 appointments today/tomorrow, this section will repeat 4 times with information about each one, with the exception of Group Appointments...


  • Group appointments
Since you probably don't need to repeat the time, subject, center, and so on for each appointment of a group session, you can use this to format those sessions differently than 1-on-1's.
  • group appointment start (appointments, repeats)
Use this to write out the non-student-specific information. Time, Center, Subject, Location, etc. Will display once for each Group Session.
  • group line
Use this to write out the student-specific information. Student name, email address, subject if you're allowing to students to book the same session for different topics. This will repeat for each Appointment within a Group Session.
  • end of group
This concludes the Group Session summary. Typically, a couple line breaks or a horizontal line like in the example above.


  • Consultant schedule email (bottom)
This text will appear at the very bottom of the email, below all appointment information, and won't repeat.


  • CC the Profile on Consultant schedule reminder emails
This option will send a copy of this email to your Profile email address if available.

Visit and Visit Duration Notification Emails



Visit and Visit Duration Notification Emails. Visit reasons can be configured with a “Notify Time Expired” setting. When that time limit is reached, an email can be sent to the center, consultant, or a specific email address automatically. This menu also allows you to configure an email that will be sent out after students conclude their visit.

8827877.png


  • Send Visit Duration Notification Emails
Choose whether or not to send notification emails when the Visit Time limit of a particular Reason is reached. [[TracCloudGuideProfileReasons|More information.]


  • Visit duration notification email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Visit duration notification email
The body of the email to be sent to your selected users.


  • Send Visit Email after Visit Conclusion
Choose whether or not an email should be sent when a Student logs out of a Center.


  • Visit email address
Choose what email address receives this email. This can be a static email address, or dynamic with a Twig Tag as seen above. This can be used to send a summary of a visit to the Student themselves, their Tutor or Assigned Advisor, a Faculty member, or another email address entirely.


  • Visit email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Visit email
The body of the email to be sent to Students/Consultants.

Send Visit Notes to Coach, Advisor or Student



Send Visit Notes to Coach, Advisor or Student can be used to send visit information to any of the previously named users, or more. The prompt to send this email can appear on individual visit records to be selected by staff, or it can be automatically initiated during visit conclusion. One of the most common uses for this feature is for Consultants to send their Visit Notes (and general Visit information) to faculty. 2376358.png


  • Activate send notes option on visit entry screen
If enabled, users with the appropriate permissions will be able to send this email via a button contained within each visit record.
6j64h43h35j36j3.png


  • Activate send notes option on KIOSK visit exit
If enabled, this email will be sent immediately upon visit logout.


  • Send Visit Notes - Email Subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • To Address of Recipient of the Notes
This controls which user these emails will be sent to.
{{Faculty.Email}} for Faculty
{{Student.Email}} for Students
{{Consultant.Email}} for Consultants or Advisors
Static email addresses, Twig Tags pointing to Custom Fields, and semi-colons for multiple email addresses can also be used.


  • 'Who' Label of the Button for Sending the Notes
The label/name of the button, as seen in the “Activate send notes” screenshot.


  • Send Visit Notes email
The body of the email to be sent to your selected users.

Resource Checkout Emails



Resource Checkout Emails contains several emails relating to resource records. Emails can be sent when an item is overdue, upon checkout, prior to the due date, prior to a reservation date, and upon return.


3583722.png

  • Send Overdue Emails
Disable this email, or choose what time it should be sent. This email will send if a student has an overdue checkout.


  • Student resource overdue email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Resource overdue email
The body of the email to be sent to Students.


  • Resource overdue SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.


  • CC the Profile on Resource overdue emails
This option will send a copy of this email to your Profile email address if available.


  • Send additional overdue emails daily
Resend the above email on a daily basis until the item is returned.


  • Student resource confirmed subject
This email is sent immediately upon resource checkout. This option affects the subject line of the email, which supports Twig tags just like the body of the email.


  • Resource confirm email
The body of the email to be sent to Students.


  • Resource confirm SMS Msg
A separate message sent to the student's phone. Requires TextAlerts Module.


  • CC the Profile on confirmation emails
This option will send a copy of this email to your Profile email address if available.

1803308.png

  • Send Resource Reminder Emails (Pickup and Return)
Choose when reservation and overdue reminders are sent. The reservation email will notify the student that an item they reserved is available for pickup based on the first day of their reservation. The return reminder will send prior to the item becoming overdue.


  • Student resource pickup/return reminder email subject
The subject line of the email, supports Twig tags just like the body of the email.


  • Resource pickup/return reminder email
The body of the email to be sent to Students.


  • Resource pickup/return reminder SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.

5176821.png

  • Resource Return Confirmation
This email allows you to send an email to the user confirming that they have returned the resource.


  • Student resource return confirmation email subject
The subject line of the email, supports Twig tags just like the body of the email.


  • Resource return confirmation email
The body of the email to be sent to the user.


  • Resource return confirmation SMS Msg
A separate message sent to the user's phone. Requires TextAlerts Module.


  • CC the Profile on resource return confirmation emails
This option will send a copy of this email to your Profile email address if available.


Workshops



Workshop emails are sent when a student is added to a workshop, removed from a workshop (canceled), and as a reminder the night before or morning of the workshop taking place. These emails can be edited in Other > Other Options > Profiles > [Your profile] > Prefs > Emails > Workshops.

8722555.png

  • Workshop enrollment confirmation email subject
This email sends when a student is enrolled in a workshop. Enter the subject line of the email here, supports Twig just like the body below.

  • Workshop confirmation email
The body of the workshop enrollment confirmation.

  • Workshop enrollment confirmation SMS Msg
A separate message to be sent to the student's phone. Requires TextAlerts module.

  • CC the Profile on workshop enrollment confirmation emails
This option will send a copy of this email to your Profile email address if available.

  • Workshop enrollment cancellation subject
This email is sent upon a student's enrollment in a workshop being canceled, supports Twig just like the body below.

  • Workshop cancellation email
The body of the workshop enrollment cancellation.

  • Workshop enrollment cancellation SMS Msg
A separate message to be sent to the student's phone. Requires TextAlerts module.

  • CC the Profile on workshop enrollment cancellation emails
This option will send a copy of this email to your Profile email address if available.

  • Send Workshop Reminder emails
You can optionally send a reminder the day before or the morning of a workshop taking place to the student's email address and/or phone number. A specific time must be chosen for this email to send.

  • Upcoming workshop reminder email subject
The subject like of the workshop reminder email, supports Twig just like the body below.

  • Upcoming workshop reminder email
The body of the workshop reminder email.

  • Upcoming workshop reminder SMS Msg
A separate message to be sent to the student's phone. Requires TextAlerts module.

  • CC the Profile on upcoming workshop reminder emails
This option will send a copy of this email to your Profile email address if available.

  • Profile Email Address is the address that all emails from this profile will be sent from. This is also the address used for "CC the Profile on..." settings.
  • Include iCal attachments enables calendar attachments for your emails. These can be added to a user's personal calendar, but this is only a one-way communication.

Other Email Articles
Not all of TracCloud's email-related settings are found in your Profile Prefs. Here are some quick links to other email settings:

Mail Servers - Looking to start using TracCloud's email capabilities, but don't have an email server setup yet? Start here.

Email Templates - Write an email as a template, and re-use it as needed when manually sending emails to Students and Staff.

Notifications - Send Notifications to Students, displayed in TracCloud directly or sent over email.

SurveyTrac Module - Send Students Surveys over email when their visit concludes, batch send to entire lists, and more.

TextAlerts Module - Send Students and Staff a text message along with their email.