Calendar¶
Requires the "Calendar" permission.
The Calendar gathers in a single calendar the appointments of all agents: those booked by operators during calls and the personal ones that agents book for themselves. From here you check each agent's workload, correct date and time, reassign an appointment to another agent, delete it or remove an outcome recorded by mistake.
Work groups
If your account has work groups and you do not have the All work groups permission, you see only the appointments of the campaigns of your groups and of those without a group (plus the agents' personal appointments, which have no campaign). An appointment of another campaign can be neither opened nor edited.
You find it in the side menu, in the OPERATIONS group, under Calendar.
Where appointments come from
From the administrator's Calendar you do not create new appointments. Appointments come from:
- operators, in campaigns with the Agenda Management module on, while handling a contact (see Booking an appointment in the operator manual);
- agents, who can book personal appointments not linked to a contact from their own calendar;
- a postponement recorded by the agent, which creates a new appointment linked to the previous one.
The calendar settings for each campaign (module on, average duration, mandatory appointment on Positive, emails to agents, assigned agents) are described in Campaign configuration.
The screen¶
The Calendar opens in Week view with All agents. At the top are the filters and the legend of the outcome colors; today is highlighted, and Saturday and Sunday are grey because they are not working days. Each appointment shows time, title (or contact) and agent.
At the top you find:
| Element | What it is for |
|---|---|
| Day / Week | Changes the view. Thelgo remembers your choice for later visits on this browser |
| ‹ and › | Previous / next day (or week) |
| Today | Goes back to the current day |
Under the header are the filters and the color legend.
Filters¶
| Filter | What it does |
|---|---|
| Campaign | Shows only the appointments that came from a campaign. With All campaigns you see them all. Agents' personal appointments belong to no campaign: with a campaign selected they do not appear |
| Agent | Shows only one agent's appointments. With All agents you see them all. The list contains only the active users with the Agent role |
Both menus have a search box to find the item quickly. The result updates as soon as you change the selection.
Filter on an agent to see their external commitments
The commitments from the agent's personal calendar (Google or Microsoft) appear only when you filter the calendar on a single agent. With "All agents" they stay hidden. See External calendar of agents.
Day view¶
On the left is the list of the day's appointments, in time order. For each one you see:
- the start time;
- the contact's name (or the title, for the agent's personal appointments);
- the campaign and the assigned agent (or No agent);
- a colored label with the outcome, or No outcome if the agent has not handled it yet, or Cancelled if Quality Check cancelled it.
If there are no appointments, "No appointments on this day." appears.
On the right is a monthly mini calendar: days with at least one appointment have a dot, non-working days are grey, today is circled. Click a day to open it; with the mini calendar's arrows you change month.
Week view¶
A grid with one column per day (Monday to Sunday) and one row per hour. Each appointment is a block placed at the right time and as tall as its duration, with time, contact and agent. Today is highlighted, non-working days are grey.
Grid hours
The grid starts and ends according to the working hours configured in General settings, and the same hours determine which days are working days. An appointment that starts earlier or ends later than those hours is shown cut at the edges of the grid. If the working hours are not available, the grid runs from 8 to 20 with all days as working days.
Colors and symbols¶
The colored bar at the left of each appointment indicates the outcome, following the legend at the top right:
| Color | Meaning |
|---|---|
| Green | Positive |
| Red | Negative |
| Amber | Suspended |
| Blue | Postponed |
| Grey | No outcome |
Other indicators:
| Symbol | Meaning |
|---|---|
| 📅 | The appointment is synchronized on the agent's external calendar (hovering over it: "Linked to the agent's Google calendar" or "…Microsoft…") |
| Cancelled by QC (Day view) / ⚠ (Week view) | Quality Check has cancelled the Positive that generated the appointment. The appointment shows the Cancelled label and stays in the calendar for the history: the agent can no longer record its outcome, postpone it or edit its note. You can delete it if it is no longer needed |
| (deleted) next to a name | The agent or operator has been deleted. The name stays visible for the history |
| (system) next to a name | It is not a person but a system user, for example Appuntamento Agente, which appears as the operator of the appointments booked by an agent from their own calendar. |
Outcomes of an appointment¶
In the calendar and in the detail, each appointment shows a single label, the outcome. If the agent has not handled the appointment yet you see No outcome; if Quality Check cancelled it you see Cancelled.
Outcomes (recorded by the agent from their own calendar; the list is fixed and cannot be customized):
| Outcome | Who sets it | Effect | Final? |
|---|---|---|---|
| Positive | Agent | The appointment is concluded with a positive outcome | Yes: the agent can no longer change it |
| Negative | Agent | The appointment is concluded with a negative outcome | Yes |
| Suspended | Agent | The agent does not yet know how it went: the appointment still needs an outcome | No: the agent can remove it themselves with "Remove hold" |
| Postponed | Agent, giving a new date and time | Thelgo creates a linked new appointment, with no outcome, for the same contact and the same agent | Yes |
Labels with no agent outcome:
| Label | When |
|---|---|
| No outcome | Appointment just created, or back to no outcome after the outcome was removed |
| Cancelled | Quality Check cancelled the contact's Positive in that campaign. The label shows on that contact's appointments and takes precedence over the outcome; the appointment no longer counts for overlaps and does not appear among the appointments to be completed. The event on the agent's external calendar is removed for the most recent appointment still to be completed (no outcome or Suspended) |
Final outcomes: only you can remove them
After a Positive, a Negative or a Postponed, the agent sees "Final outcome: only an administrator can remove it." If the agent made a mistake, you remove the outcome as explained further below.
The detail of an appointment¶
Click an appointment (in any view) to open the detail. For an appointment with no outcome yet (label No outcome), the popup has the Delete, Close and Edit buttons. When the agent records an outcome, the popup also shows the outcome box with the Remove outcome link.
The popup shows:
| Field | Content |
|---|---|
| Date and time | Day, start time and end time |
| Campaign | Campaign the appointment came from |
| Agent | Assigned agent (or "—") |
| Operator | Operator who booked it |
| Operator notes | Notes written by the operator (if any) |
| Agent notes | Notes written by the agent (if any) |
| Outcome | Outcome recorded by the agent (if any), with the command to remove it. If the campaign has an appointment outcome profile, the details chosen by the agent appear after the outcome (for example "Negative — Customer not present › Absent at the address") |
| Reminder | Appears only if a reminder was sent for the appointment: "Sent via SMS on …" (or "via Email") or, in red, "Sending failed (SMS) on …"; hovering over the error shows the reason |
| Contact details | The contact's personal data: company name, first and last name, address, city, phones, email (clickable) and filled-in dynamic fields |
For the agent's personal appointments the Contact details section stays empty, because there is no linked contact.
Edit or reassign an appointment¶
- Open the appointment and press Edit.
- Change the fields you need:
- Date, Start time, End time: the end time must be after the start time, otherwise Save stays disabled;
- Agent: choose another agent to reassign the appointment, or No agent to leave it with no assignee;
- Operator notes: the text the agent sees as the operator's note.
- Press Save. With Cancel you go back to the detail without changing anything.
In the Agent menu only the active agents assigned to the appointment's campaign appear (all agents, if the campaign has "Select all" on). If you have an Agent filter set in the calendar, the list is also narrowed by that filter: to see all selectable agents, set the filter back to All agents before pressing Edit. The currently assigned agent can always be selected.
Checks when saving
When you save a change, Thelgo applies the same checks that apply to the operator. If one is not met, saving is rejected and the message appears in red in the popup:
| Message | When |
|---|---|
| "You cannot schedule an appointment at a date/time already in the past." | The start date and time are earlier than now. The check applies at every save, even if you do not change the date: an appointment that has already started can no longer be edited or reassigned from the Calendar |
| "The appointment must be within the configured working hours (…)." | Start or end fall outside the working hours of the General settings (the configured hours appear in brackets). It does not check the days of the week. The check takes the account's time zone into account: the times are compared in local time. |
| "The agent already has an appointment in this time slot." | The chosen agent already has another Thelgo appointment or a commitment on their external calendar in that slot, and does not have the Allow multiple appointments in the same time slot permission. Cancelled appointments do not count |
| "The end time must be after the start time." | It normally does not appear because Save stays disabled |
The checks also apply if you change only the notes or leave the agent as it is.
What happens when you save:
- if the agent has linked an external calendar, the event on their calendar is updated;
- if you change agent, the event is removed from the old agent's external calendar and published on the new one's (if they have linked one);
- if you change agent, the new agent receives the notification email, under the same conditions as the one sent when the operator books the appointment (see Email notification to the agent): campaign with Emails to agents about appointments set to Email agents when an appointment is assigned, non-personal appointment, agent with an email address and email format filled in. If sending fails no error appears: in that case notify the agent yourself;
- every change is recorded in the Audit log with the Appointment edited action.
Delete (cancel) an appointment¶
To cancel an appointment you delete it:
- Open the appointment and press Delete.
- Confirm the message "Delete this appointment? This action cannot be undone.".
The appointment disappears from the calendar and, if it was synchronized, from the agent's external calendar as well. The slot becomes free again for operators.
Cancelling a postponement
If you delete an appointment that came from a postponement, the postponement is cancelled: the original appointment loses the Postponed outcome, goes back to No outcome and the agent can record a new outcome.
Remove an outcome¶
If the agent recorded an outcome by mistake:
- Open the appointment: in the Outcome box you see the current outcome.
- Click Remove outcome.
The outcome is deleted together with the chosen details, the appointment goes back to No outcome and the agent can record a new one. The operation is recorded in the Audit log.
The command works for Positive and Negative outcomes. A Suspended one is not final and the agent can remove it themselves.
A Postponed outcome cannot be removed directly: in the box you see "To cancel the postponement, delete the linked appointment.". Look in the calendar for the new appointment created by the postponement (same contact, new date) and delete it: the original appointment goes back to no outcome and no details.
Agents' personal appointments¶
Agents can book personal appointments from their own calendar, with a title of their choice and no contact or campaign. In your Calendar you see them with their title in place of the contact's name, with no campaign. You can open, edit and delete them like the others.
Remember that with a Campaign filter set, personal appointments do not appear.
External calendar of agents¶
Each agent can link Google Calendar and/or Microsoft Calendar from their own profile. The link works in two directions:
| Direction | What happens |
|---|---|
| From the external calendar to Thelgo | Commitments from the calendars the agent chose to show count as busy: an operator cannot book an overlapping appointment for them (except with the permission described below) and sees them as busy in the grid |
| From Thelgo to the external calendar | The agent's Thelgo appointments are published on the calendar the agent chose for writing, and updated or removed when you edit, reassign or delete them. If the agent has not chosen a calendar for writing, nothing is published |
In your Calendar, filtered on a single agent, the external commitments appear as "Google Calendar event" or "Microsoft Calendar event" blocks. By clicking them you see only day and time: Thelgo does not show the content of the agent's personal commitments. "All day" commitments are shown within the configured working hours.
Deleting the event from the external calendar does not cancel the appointment
If the agent deletes the event of a Thelgo appointment from their own Google or Microsoft Calendar, the appointment stays in Thelgo. To cancel it you must delete it from the Calendar.
Synchronization is "best effort": if the external calendar does not respond, the operation in Thelgo (booking, editing, deleting) still succeeds, but the external event might not be updated.
Overlaps¶
Normally an agent cannot have two appointments in the same time slot. The check applies when:
- an operator books an appointment;
- the agent postpones an appointment to a new date;
- the agent books a personal appointment for themselves;
- an administrator edits or reassigns an appointment from the Calendar.
Both the agent's other Thelgo appointments and the commitments of their linked external calendars are considered busy.
If an agent needs to be able to receive several simultaneous appointments (for example because they handle several contacts in parallel), give them the Allow multiple appointments in the same time slot permission from their page in Users. With this permission the check is not performed.
The check also applies when you edit or reassign an appointment from the Calendar (see Edit or reassign an appointment).
Email notification to the agent¶
If in the campaign Emails to agents about appointments is set to Email agents when an appointment is assigned, the agent receives an email when the operator saves the outcome with the appointment booked. The email is also sent when an administrator reassigns the appointment to another agent from the Calendar: it goes to the new agent, and the {{Operatore.…}} placeholders are not replaced.
The email is sent only if:
- the agent email format has subject and text filled in (it is set once for the whole account in the New agent appointment tab of the Email page, see Emails to agents);
- a sending server is configured (see SMTP configurations);
- the agent has an email address and is assigned to the campaign.
If one of these conditions is missing, the email simply is not sent, with no errors for the operator. If you edit only the date, time or notes of an appointment, without changing agent, no email is sent.
Daily summary¶
As an alternative to the email for each appointment, the campaign can send agents the daily summary: each agent receives a single email, at the set time, with all their appointments for the day (also from several campaigns), and whoever has none receives nothing. An appointment you reassign from the Calendar to another agent goes into the new agent's summary; appointments already completed or cancelled by Quality Check do not appear in it. Format, time and conditions are in Appointment summary to agents.
Agents who do not see operator and campaign¶
If you have granted an agent the Hide operator and campaign reference permission, in their calendar they will not see which operator booked the appointment or for which campaign. In your Calendar these data are always visible.
Working hours¶
The working hours (start time, end time and working days) are the same for the whole account and are set in General settings. They determine:
- the Calendar's time grid and the days shown in grey;
- the slots in which operators can book appointments;
- the time at which "all day" external commitments are shown.