Pre-configuring the Outlook add-in

Last Updated:

With the Zoom Outlook add-in, administrators can deploy the add-in with the single sign-on (SSO) URL preconfigured. With the URL preconfigured, users will automatically use SSO to authenticate when they interact with the add-in, such as click the Add a Zoom Meeting or Settings options in the add-in.

Notes:

  • When using custom manifest files, the add-in will not receive automatic updates, and must be updated with a new manifest file. 
  • If the add-in is deployed with a preconfigured SSO URL, this will prevent automatic logins for the add-in

This article covers:

Prerequisites for managing SSO domains for the Outlook add-in

  • SSO configured for your Zoom account
  • Account owner or admin access

How to configure the manifest file

  1. Download the manifest file for the Outlook add-in
  2. Open the manifest file in a text editor.
  3. Replace the current value in <Id>%value%</Id> with c7740fe1-f1ea-4869-9bec-fc827930b38f.
    For example if your manifest file lists the ID as <Id>a7ca6c74-33fb-43a4-a3e4-781078f0eff5</Id>, change the line to <Id>c7740fe1-f1ea-4869-9bec-fc827930b38f</Id>.
  4. Find the following lines in the Manifest (they will appear two times):
    <bt:Url id="messageReadTaskPaneUrl" DefaultValue="https://zoom.us/office365/schedule"/>
    <bt:Url id="functionFile" DefaultValue="https://zoom.us/office365/addzoom"/>
    <bt:Url id="phoneTaskpaneReadUrl" DefaultValue="https://zoom.us/office365/phoneread"/>
  5. Replace those lines with above, with the following lines respectively:
    <bt:Url id="messageReadTaskPaneUrl" DefaultValue="https://zoom.us/office365/schedule?login=sso&amp;domain=%ssodomain%"/>
    <bt:Url id="functionFile" DefaultValue="https://zoom.us/office365/addzoom?login=sso&amp;domain=%ssodomain%"/>
    <bt:Url id="phoneTaskpaneReadUrl" DefaultValue="https://zoom.us/office365/phoneread?login=sso&amp;domain=%ssodomain%"/>
  6. Modify the newly added lines by replacing "%ssodomain%" with your domain. For example, if your Vanity URL is mycompany.zoom.us, replace "%ssodomain%" with "mycompany".
  7. Save the file. 

Removing Zoom Phone option from the Outlook add-in

Currently, if deploying the manifest package provided here, the Zoom Phone option is provided, even if you do not have Zoom Phone for your account. To remove this option and prevent confusion for your users, please refer to the following instructions on how to remove Zoom Phone from the manifest:

  1. Open your modified manifest file created in the section above. 
  2. Find and delete all lines between, and including, the 2 sets of items below:
    <ExtensionPoint xsi:type="MessageReadCommandSurface">
    ...
    </ExtensionPoint>
    <ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
    ...
    </ExtensionPoint>
  3. Save the file.

How to deploy the manifest file

  1. Log in to the Office 365 Admin Portal.
  2. Click Settings to expand that section and then click Services & add-ins.
  3. Click Deploy Add-in.
  4. Click Next.
  5. Click Upload custom apps.
  6. Click I have the manifest file (.xml) on this device.
  7. Click Choose File, and select the file manifest file. 
  8. Click Upload.
  9. Choose the user assignments and deployment method, then click Deploy
  10. Once the deployment is finalized, click Close

How to update the manifest file

If you are using a custom manifest file and need to update it, you will need to download the latest version of the manifest and update the configuration. Once that is complete, to update the add-in, follow these steps:

  1. Go the Services & add-ins section of your Office 365 admin center. 
  2. Click Zoom.
  3. Click Update add-in.
  4. Choose the location of the new manifest file.
  5. Click Update.

Zoom Community

Join the 100K+ other members in the Zoom Community! Login with your Zoom account credentials and start collaborating.