Outlook and Team Calendars
On this page
Alloy Navigator connects its Web App calendars with Outlook and other calendar applications in two directions:
- Microsoft 365 integration brings Outlook into Alloy Navigator. A technician signs in to Microsoft 365 from the Web App calendar and sees their Outlook calendar there. On the Team Calendar, the same connection shows the Outlook availability of team members.
- Calendar sharing takes a user's Alloy Navigator calendar out. The user copies a personal, read-only link and subscribes to it in an external calendar application, such as Outlook, Google Calendar, or Apple Calendar.
An administrator sets up both in the Admin Center. Technicians use them in the Web App; the calendar pages are described in Calendars.
In the Admin Center
Both settings are on the Services and Integrations menu, as Microsoft 365 Integration and Calendar Sharing. The Settings App has no counterpart to either page. Both menu entries require the permission to manage services configuration; see Permissions Reference.
Set up the Microsoft 365 integration
Before you start, obtain the Tenant ID and the Client ID of an
integration registered in Microsoft Entra ID (formerly Azure Active
Directory). When a
technician signs in to Microsoft 365 from the Web App, the Web App requests
these Microsoft Graph permissions: User.Read, email, profile,
Calendars.Read, and Calendars.ReadWrite.
Prepare Microsoft Entra ID
You get the two ids in one of two ways:
- Alloy's pre-registered application. Ask Alloy Support for the Tenant ID and Client ID of the multi-tenant application that Alloy Software has registered for calendar access.
-
Your own application. Register an application in Microsoft Entra ID with these settings:
- Platform Single-page application, with the root site address of
your Web App as the redirect URI. For a Web App at
https://example.com/wp/, the redirect URI ishttps://example.com. - The delegated Microsoft Graph permissions listed above, which the sign-in requests.
- Optionally, admin consent for your organization, granted by an administrator who can consent on behalf of the organization, so that technicians are not asked to consent one by one when they first sign in.
On the application's Overview page, copy the Directory (tenant) ID into Tenant ID and the Application (client) ID into Client ID on the Admin Center page.
- Platform Single-page application, with the root site address of
your Web App as the redirect URI. For a Web App at
The registration is described step by step in Microsoft 365 Integration. For the screens in Microsoft Entra ID, see Microsoft's Register an application in Microsoft Entra ID, Configure a single-page application, and Grant tenant-wide admin consent to an application.
Enable the integration in the Admin Center
- Go to Services and Integrations > Microsoft 365 Integration.
- Select Enable integration with Microsoft 365 if it is not selected. The box activates the integration with Outlook Calendar, and it is selected until it is cleared and saved.
- Enter the Tenant ID and the Client ID. The two boxes are disabled while Enable integration with Microsoft 365 is clear.
- Click Save. Save and Cancel appear once you change the form.
To turn the integration off, clear Enable integration with Microsoft 365 and save.
NOTE: The Tenant ID and Client ID on this page serve the calendars only. A Microsoft 365 registration made for e-mail keeps its own ids in the mail settings and is not used by the calendars.
Allow calendar sharing
- Go to Services and Integrations > Calendar Sharing.
- Select Enable calendar sharing via public link.
- Save your change.
Calendar sharing is off until you turn it on. While it is off, users cannot copy a share link.
IMPORTANT: A share link opens the calendar without signing in. Anyone who has the link can read the events it carries, so treat the link as a secret.
What technicians see in the Web App
Technicians connect their Outlook calendar, add other calendars, and work with the calendars in the Web App; see Calendars. This section describes how the Admin Center settings and the person records affect what they see.
The Outlook calendar
The Web App signs the technician in to Microsoft 365 with the Tenant ID and Client ID entered in the Admin Center, and reads the technician's Outlook calendar through Microsoft Graph. A Microsoft 365 connection made on My Calendar also appears on the Team Calendar.
If Microsoft shows a Permissions requested dialog at sign-in, the technician reviews the permissions the Web App requests and clicks Accept to grant consent. Technicians are not asked for this consent when a Microsoft Entra administrator has granted admin consent for the organization.
Calendars added from an iCalendar link
A calendar that a technician adds from an iCalendar link is downloaded by the Web App server, not by the browser. The server requests the link without credentials and does not restrict which addresses it requests, and the calendar's address must be reachable from the Web App server. If the address answers with an error, the download ends with the message Failed to download the file. Recurring events are expanded, and each event keeps its summary, link, location, organizer, and description.
Before downloading a feed, the Web App converts webcal:// and webcals://
addresses to HTTPS. A Google Calendar page link containing a calendar ID is
converted to the calendar's public iCalendar feed. The link saved in the
calendar settings stays as entered.
Such a calendar is not shown on the Team Calendar: there, Other calendars lists only a Microsoft 365 source and offers no Add other calendar entry.
Outlook availability on the Team Calendar
The Team Calendar shows a member's Outlook free/busy time on that member's row. The availability appears when all of the following hold:
- The Microsoft 365 integration is enabled in the Admin Center, and its Tenant ID and Client ID are set.
- The technician viewing the page is signed in to Microsoft 365, and the Microsoft 365 source is checked.
- The member is on the page through the Assignee filter. The filter lists only active technicians within the viewer's access; inactive persons, service accounts, and persons who are not technicians are not listed.
- The primary e-mail address of the member's person record is their Microsoft 365 mailbox. Availability is looked up under this address and no other.
- The viewer's own Microsoft 365 account is allowed to see that member's availability. The lookup runs under the viewer's sign-in; the member does not need to have connected their own calendar.
The row for unassigned items shows no availability. Rows load their availability as they are scrolled into view.
If the member's primary e-mail address has no mailbox in Microsoft 365, the row shows an error icon whose tooltip reads Unable to access this calendar. No mailbox found for <address> in Microsoft 365. Other errors of the lookup are shown in the same way, with the error text of the lookup: a failed request to Microsoft Graph reads Error fetching getSchedule (<status code>): <response>, and an error that Microsoft 365 reports for the mailbox shows its message followed by its response code in parentheses, when Microsoft 365 returns one.
If a member's person record has no primary e-mail address, no availability is requested for that member and no error is shown, so the row looks the same as a row whose availability has not loaded yet. Changing a member's primary e-mail address changes the mailbox the Team Calendar asks about. Deleting the primary address stops that member's availability from appearing: no other address of the person becomes primary on its own.
Calendar share links
While calendar sharing is on, a user copies a personal share link from the calendar's customize-filters drawer in the Web App and subscribes to it in a calendar application. The link is copied to the clipboard and a message confirms it; if the server reports an error for the link, that message is shown instead. The link carries that person's calendar events within a range of days relative to today. Events that are removed are sent as canceled, so the calendar application sees that they were removed.
While calendar sharing is off, the button that copies the link is unavailable and its tooltip explains why. For a user who has access to the Admin Center, the tooltip links to the Calendar Sharing page there.