
HaloCRM Guides
Syncing Exchange Calendars (For On-Premise Web Exchange Only)
In this guide we will cover:
- Connecting to Exchange
- Syncing Appointments
Halo can sync appointments with your Exchange/Office365 calendars, and this can be restricted in different ways.
For information regarding the Graph setup please see here.
Connecting to Exchange
The Exchange Calendars module is under Configuration > Calendars and Appointments.
Fig 1. Exchange Calendars module.
Head into the module and input the relevant settings in here for the master account to the Exchange.
Fig 2. Selecting a connection method.
The information you input here comes from your exchange configuration, if you do not know these details please contact a relevant colleague. You will need to configure "App Impersonation" to facilitate this integration. Our support team can point you in the right direction to do this but cannot make any changes to your exchange instance.
Important note: As of v2.170+ the connection methods for Exchange web services have changed slightly in line with the depreciation of NHServer. The connection methods highlighted below will be available instead.
Fig 3. New connection methods.
Connection to Exchange using these methods is established in the same way as the previous versions, but the functionality of the connections has changed.
- Changes to appointments in Halo will be synced to Exchange immediately via the API. Changes to appointments in Exchange are imported via the Halo Integrator on a scheduled basis.
- The Exchange configuration screen now includes inbound/outbound logging, this allows you to monitor sync requests more effectively.
- Multi-technician appointments are no longer supported, but additional agents can be added to an appointment using the other Attendees field on an appointment.
Syncing Appointments
To turn on/off your own calendar syncing, click your profile picture, and click "My Account". Head to the "Preferences" tab and scroll down to "Calendars and Appointments".
Fig 4. Calendars and Appointments area.
Modify this setting as necessary.
Fig 5. Turning off syncing per agent.
Syncing Recurring Appointments
When creating any 'Appointment' in your Halo calendar you can now mark the entry as recurring (if you have the Exchange Calendars integration enabled).
Fig 6. Setting a recurring appointment.
This will then show a "Create Schedule" button, allowing you to create a schedule for the recurring appointment.
Fig 7. Creating a schedule.
These master appointments will then only appear in the Halo calendar if you have the following setting enabled.
Fig 8. Showing appointments on the calendar.
Once this recurring master appointment has been created, when the next Exchange Calendar sync is performed, all of the child appointments will be synced into your calendar.
Integration Not Working?
If the integration is not pulling through your appointments from your exchange calendar, it is likely that your NHServer's settings have not been adjusted to allow for calendar synchronisation.
Note: As of v2.184 NHServer had been depreciated for hosted customers. Therefore, this fix will only be applicable for on-premise customers.
To turn this on go to Configuration > Advanced Settings > Configure NHServer > then scroll down to the options that allow for calendar synchronisation, as shown in the screenshot below.
Fig 9. Syncing calendars.
Popular Guides
- Asset Import - CSV/XLS/Spreadsheet Method
- Call Management in Halo
- Creating a New Application for API Connections
- Creating Agents and Editing Agent Details
- Departments and Teams
- Halo Integrator
- Importing Data
- Multiple New Portals with different branding for one customer [Hosted]
- NHServer Deprecation User Guide
- Organisation Basics
- Organising Teams of Agents
- Step-by-Step Configuration Walk Through