Microsoft 365: administrator guide
Understand access, consent and data handling before enabling an Advanza Microsoft 365 integration.
Controlled rollout. Features depend on workspace enablement, permissions and acceptance testing. This page does not promise general availability or support for every Outlook host.
Set up Advanza for Outlook
Install the XML add-in for an approved pilot using the steps below. Installation and enabling Outlook in your Advanza workspace are separate steps. A sending-mailbox connection is not required to save Outlook items to CRM.
Prepare your account and XML file
Ask your administrator to enable Outlook for the intended Advanza workspace and provide the XML file. Use your own Outlook mailbox and an Advanza account with workspace access. Your Microsoft 365 organization must allow custom add-ins; otherwise ask IT to arrange installation. This pilot targets supported web and desktop clients, not mobile.
Install from file
Open the Outlook add-ins dialog using the link below and sign in to the mailbox where you will use Advanza. Choose My add-ins → Custom Addins → Add a custom add-in → Add from File. Select the supplied XML, review its permissions and confirm installation. Check that Advanza for Outlook is marked Added. If you received a download link, save the XML first; Add from URL is no longer available.
Find Advanza in Outlook
Close the installation dialog and open a received email. In new Outlook or Outlook on the web, choose More apps on the ribbon or Apps on the message, then Advanza for Outlook. In classic Outlook, look on the message ribbon. Open a meeting in its own window to see its ribbon. The pilot supports reading email and saved meetings, not composing an email.
Sign in and choose your workspace
Choose Sign in to Advanza in the pane. Allow the sign-in window if Outlook asks. Use your Advanza email/password or an available Google/Microsoft button; the eye button shows or hides the password. This session is separate from your normal Advanza browser session. Check the Workspace selector after sign-in. Changing workspace starts a new sign-in.
Read, choose and save
Open the email or saved meeting and choose Read current item. Select a company, contact or deal, or create a company/contact if needed. Optionally add a reminder. Review the content and acknowledge shared CRM and authorized AI visibility before choosing Save. Nothing is saved automatically. The original HTML and available inline images are saved with the activity. Other attachments are listed by name only. Open the resulting activity in Advanza for full editing.
Troubleshooting
Installed but missing
Check that Outlook uses the same mailbox as the installation dialog, open a received email and restart Outlook. Classic Outlook can take up to 24 hours to show a manually installed add-in because of caching. Contact your Microsoft 365 administrator if custom installation is unavailable.
Add-in Error or a blank pane
Close and reopen the pane. If you received an updated XML file, remove the old custom add-in through its … menu and install the new file. If the pane is still blank, contact support.
Your administrator has not enabled Outlook for this workspace
Ask the Advanza administrator to enable Outlook for the exact workspace shown in the selector, then reopen the pane. Installing the XML or connecting Microsoft sign-in does not enable this workspace feature.
Sign-in failed or the item cannot be read
Allow the sign-in window and confirm your account has access to the selected workspace. Save new meetings in Outlook before reading them. If the problem continues, send support the error text and Outlook version, without passwords or tokens.
Permissions by feature
| Feature | Microsoft permissions |
|---|---|
| To Do reminders | User.Read Tasks.ReadWrite |
| Planner tasks | User.Read Tasks.ReadWrite User.ReadBasic.All |
| Document access and media selection | User.Read Files.Read.All; SharePoint: AllSites.Read MyFiles.Read |
| Identity and renewal | openid profile offline_access |
| Appointment calendar synchronization (read and write) | User.Read Calendars.ReadWrite |
Separate connections
Microsoft sign-in, mailbox sending and Microsoft 365 integrations use separate connections. Personal features use each person's delegated access. Campaign Planner uses a separately consented workspace connection. Connecting does not grant colleagues access to Microsoft files.
Administrator consent
Start in Settings → Integrations in the intended workspace. Review the application's identity and requested permissions in Microsoft's consent screen. Your organization may require administrator approval for file access. Do not approve an unfamiliar application or paste credentials into support messages. The file picker uses a resource-specific SharePoint token for approved tenant hosts; it is separate from the Graph token.
What moves between services
Task integrations send titles, dates, status and links. Document linking keeps files in Microsoft; media import deliberately creates a copy in Advanza and uses storage quota. Protected document names require the viewer's own access. Calendar subscription links are private bearer links. Teams Workflows uses a signed webhook, not a Microsoft OAuth grant; keep its URL secret.
Disconnecting and deletion
Disconnect in Settings → Integrations to remove stored tokens and pause synchronization. Existing Microsoft tasks and files stay in Microsoft. Ordinary deletion of a synchronized campaign task is different: it also deletes that Planner task. Removing a CRM document link does not delete its Microsoft file. Revoke application consent in Microsoft separately when required by your policy.
Before a customer rollout
Validate the customer's tenant, licenses, permissions and supported hosts. Planner integration targets Basic plans. Cross-library document moves may need relinking. Outlook saving and appointment-calendar synchronization require their own acceptance; connecting a mailbox does not enable them. Microsoft-only workspace sign-in is not included. Verify publisher identity and environment-specific registration with Advanza before granting consent.
advanza