Table of contents
Outlook Calendar
Outlook Calendar gives reliable structure to the workday, showing scheduled commitments and how each person’s time is allocated. WorkSights receives calendar events in near real time with their real start, end, and duration.
For connection steps, see Connecting Microsoft 365.
What WorkSights Receives
WorkSights processes two kinds of calendar activity.
Calendar events are the scheduled events themselves, appearing as time blocks titled with the event subject and reflecting the event’s real duration. Event descriptions, agenda notes, and attachments are never received.
Calendar edits, such as creating or updating an event, appear as short Calendar Change entries titled with the event subject.
How Calendar Activity Appears
WorkSights classifies each event by its participant, excluding rooms and equipment:
- An event with one or fewer relevant participants is a Calendar Block, used for focus or personal time
- An event with two or more participants who all resolve to WorkSights users is a Meeting (Internal)
- An event with two or more participants where any is external is a Meeting (External)
Declined attendees keep their RSVP status but still count toward this rule. Events longer than ten hours are excluded from scoring. Calendar blocks are visible but not scored.
One activity is written for every mapped attendee with the calendar feature active, plus the mailbox owner, so a meeting legitimately appears on several people’s timelines. When an event is updated, the activity is rewritten in place. When an event is deleted, all matching activities are removed.
If a Teams call took place for the event, the call entry appears alongside the calendar entry. The calendar event reflects scheduled time; the call reflects what actually happened.
Troubleshooting
Calendar activity is not appearing
Confirm the tenant is connected, the user is mapped, and the Outlook Calendar feature is enabled for them.
A meeting shows as Internal but included a client, or the reverse
Categorization requires every attendee to resolve to a WorkSights user for Internal. Check the event’s attendee list and the user mappings.
The same meeting appears on several timelines
This is expected. The event is written for every mapped attendee with the calendar feature on, plus the mailbox owner.
Activity appears late
This is expected. Calendar activity processes within roughly 20 minutes.