Synchronise leaves with Outlook or Google Calendar

If you want to set up Outlook (Exchange or Office 365) or Google Calendar synchronization, please contact our support team.

Figgo can synchronize leaves in real time with Outlook or Google Calendar (for G Suite users). When a leave is created, approved or cancelled, it will be updated in the employee's calendar.

Topics covered in this article:

How does Figgo connect to the calendar?

For Outlook (Exchange or Office 365) Figgo uses an impersonation account with writing rights on the employee's calendar. For Google Calendar, Figgo uses an API access setup in the G Suite account.

What information is synced?

Event type

You can choose to display the absence type (Annual leave, sick leave...) as the event name. By default the event name is set as "Absent" for all absences.

All day events

You can choose to send all day leaves either as "all-day" events (default) or as hour range (Outlook only). When choosing hour range Figgo will use the hours defined below.

Status

When a leave request is made, a pending event (tentative) is created. When the request is approved the event is confirmed.

Initialization

You can force sync all absences in Figgo using the Initialization function at the bottom of the configuration page.

You need to set the start date: all absences after this date will be synced. You can for instance sync all future absence starting fro the beginning of the previous month.

You can also choose legal entities to sync, allowing you to select only recent entities for a syn initialization.

 

Setup with Outlook

You need to create an impersonation account on your Exchange server. Please follow the instructions below depending on your server:

Once you have created the account you can enter them in the synchronization configuration interface.

If you have an on premise Exchange server (not Office 365), you also need to enter the Exchange server URL (something like https://mail.company.com/ews/exchange.asmx). Please check if you have IP restriction, our webservice need to be allowed to communicate with the server.

Important: syncing with an Exchange server is done through HTTPS ans requires a certificate. Self signed certificates are not allowed.

Setup for Office 365

Here is how to create an impersonation account for Office 365 :

Using Windows PowerShell, connect to your Exchange Online server:

$LiveCred = Get-Credential

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell/ -Credential $LiveCred -Authentication Basic -AllowRedirection

Import-PSSession $Session

Then follow these steps:

1. Create a new user (service account). Ex: FiggoSyncAccount

2. Create a new scope "UsersWithFiggoSync" :
 
New-ManagementScope –Name:UsersWithFiggoSync –RecipientRestrictionFilter:{RecipientType -eq "UserMailbox"}

3. Assign this scope to FiggoSyncAccount :

New-ManagementRoleAssignment –Name:FiggoSync –Role:ApplicationImpersonation –User:FiggoSyncAccount –CustomRecipientWriteScope:UsersWithFiggoSync

4. Refresh to update : gpupdate /force

Use these credentials in the configuration page.

Depending on your Office 365 setup, users may be forced to change their password every 3 months. This will be an issue with the sync as the impersonation account wont be able to connect. To change this behavior for this account use the following command:
Set-MsolUser -UserPrincipalName compteServiceSynchro -PasswordNeverExpires $true 

Setup for Exchange 2015 ou 2013

Here is how to create an impersonation account for Exchange Server 2010 or 2013:

1. Create a new user (service account). Ex: FiggoSyncAccount

2. Create a new scope "UsersWithFiggoSync" :
 
New-ManagementScope –Name:UsersWithFiggoSync –RecipientRestrictionFilter:{RecipientType -eq "UserMailbox"}

3. Assign this scope to FiggoSyncAccount :

New-ManagementRoleAssignment –Name:FiggoSync –Role:ApplicationImpersonation –User:FiggoSyncAccount –CustomRecipientWriteScope:UsersWithFiggoSync

4. Refresh to update : gpupdate /force

Use these credentials in the configuration page.

Depending on your Office 365 setup, users may be forced to change their password every 3 months. This will be an issue with the sync as the impersonation account wont be able to connect. To change this behavior for this account use the following command:
Set-MsolUser -UserPrincipalName compteServiceSynchro -PasswordNeverExpires $true 


Setup with Google Calendar

In G Suite you need to authorize Lucca to edit user's calendar:

  • Go to https://admin.google.com/AdminHome. Then "Security" > "Advanced Settings" > "Manage API Client Access".
    Reminder: the sync with Figgo is only avialable for G Suite users (formerly Google Apps). It is not available on personnal Google accounts.
  • You should have the following screen:

Image1.png

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments