Emails to agents (New agent appointment)¶
Requires the "General settings" permission.
The New agent appointment tab of the Email page (menu CONFIGURATION → Email) contains the format of the email automatically sent by the system to the agent when an appointment is assigned to them. The page subtitle, with this tab open, is "Formats of the emails sent automatically by the system". There is only one format: the agent email. To receive instead a single email per day with all the appointments, see Appointment summary to agents.
Looking for the emails operators send to contacts?
The emails the operator chooses in the Send email section of the handling screen (see Sending an email) are not configured here: they are the email templates, which you prepare in the Email template for campaign tab of the same Email page and enable campaign by campaign (see Email templates).
The tab shows the Agent email format with the SMTP configuration, the default subject, the visual editor with the default text and, below, the placeholder buttons, including {{Appuntamento.DataOra}}, {{Appuntamento.Data}} and {{Appuntamento.Ora}}.
Agent email format¶
"Email sent to the agent when an appointment is assigned to them (can be enabled per campaign, but with a single format for the whole account)."
When the email is sent¶
The email is sent to the agent when all these conditions are true:
- in the campaign, in Emails to agents about appointments, the Email agents when an appointment is assigned option is chosen (see Campaign configuration);
- the operator saves the contact's outcome with an appointment assigned to an agent (or an administrator reassigns an appointment to another agent from the Calendar);
- both the Subject and the Text are filled in here;
- the agent has an email address in their user form;
- the chosen SMTP configuration is available.
It is a "courtesy" notification: if sending fails, the operator sees no errors and the outcome is saved anyway (the same applies to the administrator who reassigns an appointment). If an agent reports not receiving emails, check the points above and test the SMTP configuration with the test button (see SMTP configurations).
The fields¶
| Field | What it does |
|---|---|
| SMTP configuration | The mailbox the email is sent from. Thelgo SMTP (with the sender address in brackets, if available) is the shared mail server of the service; the other entries are your own SMTP configurations |
| Subject | The email subject. It can contain placeholders |
| Text | The email body, written with the editor (see below). It is always sent as HTML |
Press Save to confirm: the green message "Email format saved." appears at the bottom.
Reset to default¶
The Reset to default button brings Subject and Text back to Thelgo's default template (subject "Nuovo appuntamento in agenda: {{Nominativo}}" (New appointment in the calendar: {{Nominativo}})). It does not change the SMTP configuration and does not save: if you change your mind, reload the page without pressing Save.
The text editor¶
The text is written with the same editor as the email templates:
- visual editor (default): bold, italic, underline, color, headings, alignment, bulleted and numbered lists, links and tables, as in a word processor;
- View HTML code: switches to the HTML code, useful for pasting a template prepared by a designer. With View visual editor you go back to the normal view. The two views work on the same text.
Available placeholders¶
Below the editor, "You can use placeholders for contact and operator fields in the text.": click a button to add the placeholder at the end of the text, then move it where needed. At sending time each placeholder is replaced with the real value.
| Placeholder | Value |
|---|---|
{{Nominativo}} |
The contact's first and last name, or the company name if first and last name are missing |
{{RagioneSociale}}, {{Nome}}, {{Cognome}} |
The contact's personal data |
{{Indirizzo}}, {{Cap}}, {{Comune}}, {{Provincia}} |
The contact's address |
{{Telefono1}}, {{Email}} |
The contact's first phone number and email |
{{Operatore.Nome}}, {{Operatore.Cognome}}, {{Operatore.Username}}, {{Operatore.Email}} |
The operator who booked the appointment |
{{Agente.Nome}}, {{Agente.Cognome}}, {{Agente.Username}}, {{Agente.Email}} |
The recipient agent |
{{Appuntamento.DataOra}} |
Date and time of the appointment (format dd/mm/yyyy hh:mm) |
{{Appuntamento.Data}} |
Only the date of the appointment (format dd/mm/yyyy) |
{{Appuntamento.Ora}} |
Only the time of the appointment (format hh:mm) |
The appointment time is written in the account's time zone. This applies both to the email sent when the operator assigns the appointment and to the reassignment one.
You can also write by hand other contact fields, with the same name used in the email templates (see Email templates). Names must be written exactly like this, capitalization included: an unknown placeholder, or one without a value, stays in the text as it is.
Does the agent see operator and campaign?
If an agent has the Hide operator and campaign reference permission (see Users), remember that this permission only hides the data in their calendar: if you use the {{Operatore.…}} placeholders in the email text, the agent will still receive them by email. In the email sent when an administrator reassigns an appointment from the Calendar, the {{Operatore.…}} placeholders are not replaced: the agent would see them written like that (with the double braces). If you want to use the same format for both cases, avoid the operator placeholders.
Email with credentials¶
The email with username and password sent with Create and send credentials (see Users) cannot be customized from here: it is a single format managed by the service provider.