<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}</style><p><strong>In this guide we will cover:</strong></p><p id="isPasted"><strong>- Using the Calendar</strong></p><p><strong>- Viewing Entries in the calendar</strong></p><p><strong>- Creating Appointments</strong></p><p><strong>- Appointment creation Screen</strong></p><p><br></p><p><br></p><p>The calendar module in Halo can be used to view, track and manage agent appointments, holidays, tasks, change requests, projects and scheduled tickets. Agents will each have their own calendar, but can also be given access to other agents' calendars for visibility/management purposes. </p><p><br></p><p><br></p><p><strong>Admin Guides:</strong></p><ul><li><strong><a href="https://usehalo.com/haloitsm/guides/1837/" rel="noopener noreferrer" target="_blank">Calendars and Appointments General Settings</a></strong></li><li><a href="https://usehalo.com/haloitsm/guides/1836/" target="_blank" rel="noopener noreferrer"><strong>Appointment Types</strong></a></li><li><a href="https://usehalo.com/haloitsm/guides/1377/" target="_blank" rel="noopener noreferrer"><strong>Exchange Calendars</strong></a></li></ul><p data-pasted="true"><strong>Related Guides:</strong></p><ul><li><a href="https://usehalo.com/haloitsm/guides/2115" target="_blank" rel="noopener noreferrer"><strong>Shifts</strong></a></li><li><a href="https://usehalo.com/haloitsm/guides/1901" target="_blank" rel="noopener noreferrer"><strong>Holiday Management</strong></a></li><li><a href="https://usehalo.com/haloitsm/guides/1939/" target="_blank" rel="noopener noreferrer"><strong>Appointments</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">Using the Calendar</span></strong></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdhNDFhNWVmLTRiZWQtNGI1Yy1iOTAwLWI1MWJkOTAzMjI2MCJ9.7DfZUWMQA99POmD1fpB_ISoQhOM2jIclJmpsZbgsbLw" class="fr-fic fr-fil fr-dib" width="177" height="176"></p><p><strong><span style="font-size: 10pt;">Fig 1. Calendars and Appointments module </span></strong></p><p><br></p><p>You can access the calendar through the navigation pane. The buttons at the top of the page give you control over your view of the calendar. You can view specified intervals, or you can click on the timeline view, which is a horizontal display of events per hour over a chosen day.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUzMDY3ZWFhLTQ2YTItNGZkZC1iZWNhLTA4YWZjMTg4Mzg3NyJ9.41ajoiRf8b3SYd88QpFRFSu5hTPziMviwlXxMaMpM1A" class="fr-fic fr-fil fr-dib" width="1203" style="width: 1205px; height: 583.494px;" height="583"></p><p><strong><span style="font-size: 10pt;">Fig 2. Calendar timeline </span></strong></p><p><br></p><p>Hovering over an entry in the calendar will show information about it. Clicking the appointment will show more information still, such as the ticket that is associated with the entry, and will allow you to make amendments to the appointment. </p><p><br></p><p><strong><span style="font-size: 14pt;">Viewing Entries in the calendar</span></strong></p><p>The calendar module provides you with various ways in which to view appointments. </p><p><br></p><p>The buttons at the top of the page here will control the time period to view calendar entries for, whether to see appointments for the coming day, week or month. Agenda will show a list view of all upcoming entries. Timeline will display upcoming entries using a horizonal timeline, with a marker denoting the current time. Selecting the time period prior to selecting the timeline button will determine for what time period the timeline will show entries for. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIyOTM4ODdkLTAwZmYtNDIxYy04YTcxLTAzNmQ1M2ZhNGE3ZCJ9.y9iPprFxSnaz0fO3AUCP68-zjdHomCJKfyooLLKVwpo" class="fr-fic fr-fil fr-dib" width="1245" style="width: 1247px; height: 230.699px;" height="231"></p><p><strong><span style="font-size: 10pt;">Fig 3. Timeline view of appointments</span></strong></p><p><br></p><p>You can also filter what calendar entries show using the left hand pane on the calendar screen. Entries can be filtered by:</p><ul><li>Entry types</li><li>Appointment type</li><li>Assigned agent</li><li>Assigned customer/top level of this customer</li></ul><p>You can filter what type of entries show in the calendar, that is whether appointments, holidays, tasks, change requests, projects and scheduled tickets show. To control this, hover over the cog icon in the calendar filter pane and select the entities you would like to see in the calendar. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJkZWNiMTNmLWNhMzItNDBjOS04NmYwLTFjNjViYzc1M2RmYyJ9.t5z1GrX49UMR2RkN3HfzxKKfsh_fkLqAbrgDOCBaFUU" class="fr-fic fr-fil fr-dib" width="635" style="width: 637px; height: 701.026px;" height="701"></p><p><strong><span style="font-size: 10pt;">Fig 4. Filter entry types in the calendar</span></strong></p><p><br></p><p>Only the entries for the entities ticked in this list will show in the calendar. </p><p><br></p><p><strong>Show only recurring master appointments </strong>- When selected, no other entry types will show in the calendar, only recurring master appointments. Recurring master appointments are used when creating recurring appointments.</p><p><br></p><p>When viewing appointments in the calendar, you can filter what appointment types show using the 'appointment types' section in the calendar filter pane. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI0NDQxZGMwLTdjYjQtNGRhMC1hMWZlLTAyNWRmZDA4YzVlOCJ9.7yd1F7S1RZSuyrD72XmeUNeXrBwd7L7XiMCJ_RVeWQw" class="fr-fic fr-fil fr-dib" width="343" style="width: 345px; height: 474.272px;" height="474"></p><p><strong><span style="font-size: 10pt;">Fig 5. Appointment type filter</span></strong></p><p><br></p><p>Simply select the appointment types that you would like to be visible, or use the checkbox to select all appointment types. </p><p><br></p><p>To filter entries based on the assigned agent, use the 'Agent Calendars' filter in the calendar filter pane. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5YTU3YWQ2LTVmMjMtNGM1My1hNjQ4LWE2NGM4NmJlNjJkZiJ9.PRaNubnYWMA_q3qzXG6fC0pVGb4QiGnIgb7r_e9x9nI" class="fr-fic fr-fil fr-dib" width="533" style="width: 535px; height: 675.139px;" height="675"></p><p><strong><span style="font-size: 10pt;">Fig 6. Filter by assigned agent</span></strong></p><p><br></p><p>This will control which agent's calendar you will see. You will only be able to select the agents whose calendar you can access (determined by agent permissions). Simply select the agents you would like to see the calendar of, using the team dropdown to navigate through agents. </p><p><br></p><p>You can also filter your calendars by Agents with specific qualifications. To enable this, head to Configuration > Calendars and Appointments > General Settings, and select "Show the Qualification filter within the calendar". When this is enabled an additional dropdown will show allowing you to select a qualification to filter by. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc0YzExOWEzLWM5NTQtNDQ0Ni1hMDcwLTUxYmQ5ZWY3NTk3OSJ9.0MPcVa2DT_o8YpYoWuPx7Etof0eilX92TymzQ6nkkLg" class="fr-fic fr-fil fr-dib"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 7. Filter by qualifications </span></strong></p><p><br></p><p>By default, when opening the calendar you will see the calendars of all the agents you have access to. You can change this behaviour so that the calendar will show the logged in agent's calendar by default. To do this head to configuration > calendars and appointments > general settings > general settings > enable 'Always default calendar selection to the logged in Agent'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVlZTRiZmExLTYxNzItNDUxMy05ZmUxLWZhNjNhZTZmODFlOSJ9.QvA1e8vFkVIO7Bp9_QHaiiVWerap5TXeQD1cDatd4Bo" class="fr-fic fr-fil fr-dib" width="613" style="width: 615px; height: 414.094px;" height="414"></p><p><strong><span style="font-size: 10pt;">Fig 8. Default calendar selection to the logged in Agent</span></strong></p><p><br></p><p>To filter by the customer or top level that is assigned to the calendar entry (this will be the customer of the ticket associated with the entry) use the 'filters' section of the calendar filer pane. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVhNTY4YjRlLTFjYmYtNGYzZi1hY2JjLWQxMTY1Yzc1MTBkMiJ9.NssClMHbkss62lUkkM2YX4C2LK37RkVw91ZeQ-vphK0" class="fr-fic fr-fil fr-dib" width="598" style="width: 600px; height: 689.446px;" height="689"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 9. Filter calendar entries based on customer/top level</span></strong></p><p><br></p><p data-pasted="true">From v.2.236+, when in day or week view, you can display an Agents actual hours, target hours and availability percentage on top of the calendar. To enable this head to Configuration > Calendars and Appointments > General Settings, and select the "Display the Agents availability overview on the calendar" checkbox. </p><p style='margin: 0px; color: rgb(0, 0, 0); font-family: "Segoe UI", "Segoe UI Web (West European)", "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;'><br></p><p style='margin: 0px; color: rgb(0, 0, 0); font-family: "Segoe UI", "Segoe UI Web (West European)", "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;'><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRhNjJlY2ZiLTVlOWUtNDU3My04NjI3LTQyNDVjMTJjMjQ4MCJ9.1HJD385uuIj4PPSFLOnY9rgUIrRafo-YE2_ipW3OUoU" width="589" height="264" style="max-width: 100%; height: 263.794px; text-align: left; width: 591px;" class="fr-fil fr-dib"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 10. Display the Agents availability overview on the calendar </span></strong></p><p><br></p><p>Once enabled each Agent will have an overview header against their calendar. Availability is calculated off of appointments and the agents timesheet and mirrors what is displayed on the planning view of the timesheet screen. </p><p style='margin: 0px; color: rgb(0, 0, 0); font-family: "Segoe UI", "Segoe UI Web (West European)", "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;'><br></p><p style='margin: 0px; color: rgb(0, 0, 0); font-family: "Segoe UI", "Segoe UI Web (West European)", "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;'><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNmZmJkM2ZhLTEyNDEtNDc2NC1iYmEyLTcxYmQ3NjlmYzFjOSJ9.yIUIIxF6JAjCVaGzf18RNM7_C3hNbW0Rnp4Z-84lE_Q" width="919" height="418" style="max-width: 100%; height: 418.165px; text-align: left; width: 921px;" class="fr-fil fr-dib"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 11. Availability overview </span></strong></p><p style='margin: 0px; color: rgb(0, 0, 0); font-family: "Segoe UI", "Segoe UI Web (West European)", "Segoe UI", -apple-system, BlinkMacSystemFont, Roboto, "Helvetica Neue", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;'><br></p><p><strong><span style="font-size: 14pt;">Creating Appointments/Tasks </span></strong></p><p>Appointments and tasks can be created from either the calendar module, within a ticket, or from an integration. </p><p><br></p><p>To create an appointment/task in the calendar module you can click and drag on the calendar page on the day/time you would like to log an appointment for. Then choose whether the entry is for an appointment or a task. (If you are using Shifts and Holidays these will also be event type options).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ0OWQyNjYwLTYzMDQtNDJiZS1iNTlmLTFlYzIyMGZkMDVhMCJ9.68szxiAEa7N-zvZh30iQMIR67EjI8lMsHdz_UwJni1U" class="fr-fic fr-fil fr-dib" width="1184" style="width: 1186px; height: 748.338px;" height="748"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 12. Making an appointment </span></strong></p><p><br></p><p>You can remove agents' ability to log 'Task' entries in the calendar. This is enabled under Configuration > Calendars and Appointments > General Settings > "Hide Task from Event Types".</p><p><br></p><p>Appointments can be imported from third party applications that we integrate with, such as <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1198" id="isPasted" target="_blank" rel="noopener noreferrer">Exchange Calendars</a>. When integrated, each time an appointment is created in the third party application this will sync across to Halo. </p><p><br></p><p data-pasted="true">If creating from an appointment in the calendar screen, you can have appointments not linked to a ticket. You can default the time taken field on these appointments to take the duration of the appointment in Configuration > Calendars and Appointments > Appointment Settings, by enabling the below setting.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIwZTVlMjEzLWExYTEtNDAzYy1hZTViLTk5NGY3OGRmYjg3MCJ9.rZ_xH5J6O9KddoLxzadegct0egJL7H3QK0IKPox-bRA" class="fr-fic fr-fil fr-dib" width="731" height="33"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;" data-pasted="true"><strong style="box-sizing: inherit; font-weight: bolder;"><span style="box-sizing: inherit; font-size: 10pt;">Fig 11. Enabling default time taken.</span></strong></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: Poppins, sans-serif, Roboto; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;" data-pasted="true"><br></p><p data-pasted="true">You can '@' mention agents within the notes of an appointment. This is useful for agents to mention a team to ask for cover, or inform them of any changes. Upon the notification sending out, clicking on it will open the appointment details where the note can be viewed.</p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; color: rgb(0, 0, 0); font-family: Poppins, sans-serif, Roboto; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0NWY1OGIwLTZiY2MtNDEwOS1iOWI5LTEyOGI5ODZlMzA5NCJ9.uUHehZMoBeN7dcLQv3xTxfSWE7EQA0IJbBHoq5pPBf0" width="1007" height="763" style="box-sizing: inherit; border-style: none;" class="fr-fic fr-dii"></p><p data-pasted="true"><span style="font-size: 10pt;"><strong>Fig 13. Mention on an appointment </strong></span></p><p><br></p><p>Once saved, you can edit a calendar appointment by clicking into the entry. To enable the linked Ticket ID to be changed on an appointment you will need to choose an option in the</p><p data-pasted="true">"Allow the linked Ticket property to be edited on an Appointment" drop-down. Here you can allow the Ticket ID to be changed "Never", "When an appointment already has a linked Ticket", or "Always".</p><p><br></p><p>For more information on creating appointments, including how to raise appointments from tickets please see our guide on <a href="https://usehalo.com/halopsa/guides/1939" target="_blank" rel="noopener noreferrer"><strong>Appointments</strong></a>. </p>
