Setting up the calendar invite integration

The Systam Visit calendar invite integration brings visitor details from your calendar straight into visitor management. The host creates a normal calendar invite, adds your company's invite address, and Systam Visit handles the rest. Guests receive a pre-visit message and QR code automatically.

This guide is for the IT contact who handles the invite address and calendar environment configuration.

How the integration works

1. The host creates a calendar event in their calendar. The event contains an iCalendar-standard (RFC 5545) invite.
2. The host adds guest email addresses and the company-specific invite address to attendees.
3. The invite address forwards the calendar invite to Systam's customer-specific mailbox.
4. Systam Visit reads the invite automatically, creates a visit and sends the pre-visit message to guests.

Setup options

You can roll out the integration in four ways. Pick the one that suits your environment best.

1. Direct invite address

Systam provides an invite address ending in @respamanager.fi (e.g. customer@respamanager.fi). The host adds the address directly to the calendar invite attendees.

This requires no configuration on the IT side. Good for piloting and small environments.

2. Company-specific internal address with forwarding

Customer IT creates a resource or shared mailbox in the company email environment (e.g. visitors@company.com) that forwards incoming emails to the Systam-provided @respamanager.fi address.

The user sees the company's own address. Requires IT to create a forwarding rule.

3. Outlook Add-In

The Systam Outlook Add-In adds a button to the calendar that attaches the invite address to the event with one click. The user does not need to remember the address.

Suits O365 environments. The Add-In is distributed centrally via Microsoft 365 Admin Center.

4. O365 or Google Workspace room resource configuration

A customer-specific room resource (e.g. a meeting room calendar resource) is configured so that it attaches the invite address automatically when the resource is booked via a calendar invite. This option also ties the integration into Systam Rooms room booking views.

What the calendar invite must contain

The invite must contain at least:

• The visit host (invite sender)
• At least one guest (attendee)
• The visit profile (invite address)
• The visit date and time

What data is processed

The integration processes only the calendar invite attachment from incoming emails. The following are stored in Systam Visit:

• Invite sender (host)
• Invite attendees (guests)
• Invite timestamp
• Invite title
• Invite unique identifier (UID)
• Optionally configured: invite location (e.g. meeting room)

All incoming emails and invite attachments are permanently deleted from Systam servers. This includes messages that could not be processed.

How guest details are built

The host and guests are looked up by email address. If a person is not found, a new record is created.

The name is taken primarily from the common name attached to the email address, e.g. Matti Meikäläinen <matti.meikalainen@yritys.com>. The guest's organisation can be derived from the domain.

If the common name is missing, the name is parsed from the local part of the email address:

• matti.meikalainen@yritys.com → Matti Meikalainen
• matti.matias.meikalainen@yritys.com → Matti Meikalainen
• meikalainen.matti@yritys.com → Meikalainen Matti (note: order may be reversed)
• matti@yritys.com → name cannot be derived
• sales.team3@yritys.com → Sales Team3 (note: not a person's name)

If a name cannot be derived, the guest is stored with only the email address. The host is asked to complete the missing details.

Summary to the host

Once the invite has been processed, the host receives an email summary of the added visit details with a link to complete the data. The link is not generated in serviced office sites.

Troubleshooting

If a calendar invite does not create a visit, check that:

• The invite address is in attendees
• The invite has at least one other attendee besides the invite address and the host themselves
• The invite has a start and end time
• If using a forwarding rule, that the forwarding is active and the message has not been held in spam filtering

That's it! Once it's set up, calendar invites pre-register your visits for you.