View source for TracCloud: Emails

{{TracCloudGuideTabs}}
{| style="width:100%; vertical-align:top; "
| style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TracCloudGuideProfileTOC}}
| style="vertical-align:top; padding:20px 20px 20px 2px;" |
{| style="width:100%; vertical-align:top; "
<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 article will provide an overview of these email types, what they do, and how they can be customized for your use-case.<br><br>

''Other > Other Options > Profiles > [Your Profile] > Prefs > Emails''.
<br>
[[File:4225012.png|900px]]
<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>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.


* <b>Send Confirmation to Consultant Also</b>
::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:3003554.png|900px]]<br><br>

* <b>Send Reminders Emails</b>
::Disable Reminder emails, or choose to send them the night before or the morning of the Appointment date at a specified time.


* <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>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>
<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>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>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>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>Student appointment missed email</b>
::The body of the email to be sent to Students.


* <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>
* <b>Cancel recurring appointments after # consecutive student cancellations</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>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>CC the Profile on Student/Consultant auto cancellation emails</b>
::This option will send a copy of this email to your Profile email address if available.

</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.

[[File:3240827.png|900px]]
<br><br>
* <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>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.


* <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>
[[File:9332607.png|900px]]
<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>
::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 (bottom)</b>
::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>
<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.


* <b>Visit email</b>
::The body of the email to be sent to Students/Consultants.
</div>
<hr>
<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>
<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>
::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|500px]]


* <b>Activate send notes option on KIOSK visit exit</b>
::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>
<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> are the emails sent upon a resource being checked out or marked as overdue. Overdue emails can repeat for each day the resource isn't returned.
[[File:3583722.png|900px]]<br><br>

* <b>Send Overdue Emails</b>
::Disable this email, or choose what time it should be sent.


* <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 if the Resource is not returned.


* <b>Student resource confirmed subject</b>
::This email is sent immediately upon Resource checkout. This option effects 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.
</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>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.

<hr>
<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:

<b>[[TracCloudTechMail|Mail Servers]]</b> - Looking to start using TracCloud's email capabilities, but don't have a Mail Server setup yet? Start here.

<b>[[TracCloudGuideGlobalTemplates|Email Templates]]</b> - Write an email as a template, and re-use it as needed when manually sending emails to Students and Staff.

<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]]