Appointment reminder¶
Requires the "General settings" permission.
The appointment reminder is a message (SMS or email) that Thelgo automatically sends to the contact on the day of the appointment, to remind them of the meeting with the agent. You set it up in two steps:
- you prepare one or more templates in the Appointment reminder template tab of the SMS page (for SMS reminders) or of the Email page (for email reminders);
- you turn on Appointment reminder in the campaigns that need it, in the Modules and operators step (see Campaign configuration).
How it works¶
An automatic check runs every minute. When the time of day (in the account's time zone) matches the sending time of the template chosen by a campaign, Thelgo sends the reminder to the appointments of that campaign that meet all these conditions:
- they have today's date and a start time not yet passed;
- they have no outcome (with a Suspended outcome the reminder is not sent);
- they have not been Cancelled by the Quality Check;
- they are linked to a contact (the agent's personal appointments receive no reminder);
- the contact has not been anonymized (see Anonymization);
- a reminder has not already been sent for that appointment.
The reminder is therefore sent only once per appointment, and a failed send is not retried. If you create or move an appointment after the sending time of the day, nothing will be sent for that day.
Times in the account's time zone
Both the sending time of the template and the time written in the message follow the account's time zone (for Italian companies Europe/Rome, the default value), daylight saving time included. Also "today" and the time "not yet passed" are calculated in that time zone.
The reminder goes to the contact's first phone number (SMS) or to their email address.
Where you see the sending result¶
In the appointment detail, in the administrator Calendar, in the operator's detail window and on the agent's page, the Reminder row appears:
| Row | Meaning |
|---|---|
| Sent via SMS on … (or via Email) | The reminder was sent, with the date and time of sending |
| Sending failed (SMS) on … (or (Email)), in red | Sending failed: hovering over the row shows the reason (see the table below) |
If the row is not there, no attempt was made for that appointment.
For an appointment of today the row can read, for example, "Sent via Email on 03/11/2026 08:27". The appointment stays No outcome: the reminder does not change the outcome.
Error reasons you may find:
| Reason | What to do |
|---|---|
| "Numero di telefono del nominativo mancante." (The contact's phone number is missing.) | The contact has no first phone number: correct the data in the contact |
| "The SMS module is not active for this campaign." | For SMS reminders the campaign must also have the Preset SMS module on (see Campaign configuration) |
| "The sender alias of this template has not been verified yet." | The template's alias is Pending or Rejected: wait for approval or choose another (see SMS) |
| "Indirizzo email del nominativo mancante." / "Indirizzo email del nominativo non valido." (The contact's email address is missing. / The contact's email address is not valid.) | Correct the email in the contact |
| "Nessuna configurazione SMTP disponibile per questo formato email." (No SMTP configuration available for this email format.) | The template has no SMTP configuration and there is no usable shared SMTP: choose one in the template |
| Another message | It is the reason returned by the sending service (SMS or email) |
The templates¶
The template is common to all campaigns: you prepare it once and choose it in the campaigns you want.
| Field | SMS template | Email template | Notes |
|---|---|---|---|
| Description | Yes | Yes | Required. It is the name you see in the list and in the campaign choice |
| Send at | Yes | Yes | Required. The time of day the reminder is sent |
| Sender alias | Yes | No | SMS: required. It appears with the status in brackets if it is not yet Verified |
| SMTP configuration | No | Yes | Email: the mailbox the message is sent from. Leaving Select uses the service's shared SMTP, if available |
| Subject | No | Yes | Email: required |
| Text | Yes | Yes | Required. For SMS, under the field there is the counter "N characters · M SMS" (one SMS every 160 characters); for email there is the editor with View HTML code, as in the email templates |
In the template list you see Description, Send time, Sender alias (SMS) or Subject (email) and Linked campaigns, that is, how many campaigns use the template (the number is clickable: it opens the Linked campaigns: … popup with the campaign list, and clicking a campaign opens it; with 0 the button is disabled). Click a row to edit the template, the trash can deletes it.
On the SMS page, on the Appointment reminder template tab, the subtitle reads "1 reminder templates registered" (the count of templates), there is the + New reminder template button and the table with Description, Send time, Sender alias and Linked campaigns.
The Edit reminder template form of the SMS page has Description, Send at, Sender alias, Text (with the counter, for example "73 characters · 1 SMS") and the placeholder buttons, including {{Agente.Nome}}, {{Agente.Cognome}}, {{Appuntamento.DataOra}}, {{Appuntamento.Data}} and {{Appuntamento.Ora}}.
The Edit reminder template form of the Email page has Description, Send at, SMTP configuration, Subject, the Text editor and the same placeholder buttons.
To save, the SMS form requires description, time, alias and text (the Save button stays off until something is missing). In the email form Save becomes active with description and time, but if Subject or Text are missing the save is rejected with "The email subject is required." or "The message text is required.". Other possible messages:
| Message | Where | Meaning |
|---|---|---|
| "The description is required." | SMS and email | The description is missing |
| "Invalid send time." | SMS and email | The time is not valid |
| "You must first create a sender alias (even if not verified yet) to create an SMS reminder template." | SMS | No alias exists. + New reminder template is disabled until you create one |
| "The selected sender alias no longer exists." | SMS | The alias was deleted in the meantime: choose it again |
| "Unable to save the SMS reminder template." / "Unable to save the email reminder template." | SMS and email | Generic error: try again |
If you choose an alias that is not yet verified, "This alias is not verified yet: you can save the template but sending will stay blocked until it is approved." appears.
Placeholders¶
Below the text you find the placeholder buttons: clicking them adds the placeholder at the end of the text. At sending time Thelgo replaces it with the real data.
| Placeholder | Value | SMS | |
|---|---|---|---|
{{Nominativo}}, {{RagioneSociale}}, {{Nome}}, {{Cognome}}, {{Indirizzo}}, {{Cap}}, {{Comune}}, {{Provincia}}, {{Telefono1}}, {{Email}} |
Data of the contact who has the appointment | Yes | Yes |
{{Operatore.Nome}}, {{Operatore.Cognome}} |
The operator who booked the appointment | Yes | Yes |
{{Operatore.Username}}, {{Operatore.Email}} |
As above | No (no button) | Yes |
{{Agente.Nome}}, {{Agente.Cognome}} |
The agent the appointment is assigned to | Yes | Yes |
{{Agente.Username}}, {{Agente.Email}} |
As above | No (no button) | Yes |
{{Appuntamento.DataOra}} |
Date and time of the appointment, in the format dd/mm/yyyy hh:mm |
Yes | Yes |
{{Appuntamento.Data}} |
Only the date, in the format dd/mm/yyyy |
Yes | Yes |
{{Appuntamento.Ora}} |
Only the time, in the format hh:mm |
Yes | Yes |
The rules of the email templates apply: names must be written exactly like this, and an unknown placeholder, or one for an empty field, stays in the message as it is. If the appointment has no assigned agent, {{Agente.Nome}} stays written as it is.
Deleting a template¶
The trash can (after the browser confirmation "Delete the reminder template "…"?") deletes the template. You cannot delete a template still chosen as a reminder in a campaign: "Cannot delete a template still selected as a reminder in one or more campaigns: remove it from there first." appears. First remove the template from the campaign (or turn the reminder off) and then delete it.
Enabling the reminder in a campaign¶
In the campaign configuration, Modules and operators step, Agenda Management module:
- Turn on Appointment reminder. The option is disabled, with the hint "No reminder template available: create one in Configuration → SMS/Email.", until at least one usable template exists.
- If SMS are available for your account, choose the Reminder channel: SMS or Email. If SMS are not available the choice does not appear and the channel is always Email.
- Choose the Reminder template from the menu: each entry shows description and sending time, for example "Reminder (09:00)". The template is required: until you choose it you cannot save the campaign.
Changing the channel clears the template choice. The option is part of the Agenda Management module: turning the module off turns the reminder off.