Custom Zoom App

There may be situations where the published Zoom applications are not suitable for a customer's needs. This includes Nectar DXP running in customer's on-prem environments or in private cloud environments. In these cases, the customer can create their own custom private OAuth application in the Zoom App Marketplace. These apps do not appear in the App Marketplace. This document outlines the steps necessary to create a private Zoom OAuth application.

1. Log onto the Zoom App Marketplace using an account that has the rights to create applications.
2. Click the Develop button and select Build App. Alternatively, go directly to the Create App page.
3. On the Choose your app type page, select the Create button under OAuth.
4.  Enter the following details in the Create an OAuth app window.
   1. Type a descriptive name such as 'Nectar DXP'
   2. Under Choose app type, select Account-level app
   3. De-select the option to publish the app on the Zoom App Marketplace
   4. Click Create.
5. On the next page, copy the Client ID and Client Secret to provide to Nectar personnel
6. Under Redirect URL for OAuth, enter the URL that will be provided to you by Nectar personnel. The URL should end with /adminapi/zoom/oauth/authorize. Example: https://customer.us.nectar.services/adminapi/zoom/oauth/authorize
7. Under Oauth allow list, add the base FQDN. Example: https://customer.us.nectar.services
8. Press Continue to move to the next page. 
9. On the Basic information section, enter a short description such as "Advanced call quality analytics, reporting and troubleshooting for your Zoom calls, conferences and webinars"
10. For the long description, enter some text, such as "The Zoom Admin Dashboard is an excellent meeting/webinar focused tool that allows you to see all your live and past meetings/webinars. It is not as well suited for finding and solving quality-related issues. Nectar DXP makes it easy to find issues that may be affecting your Zoom user's meeting experience."
11. Under the Developer Contact Information section, enter your name and email address.
12. Press Continue to move to the next page. 
13. On the Add Feature page, enable the button for Event subscriptions and click +Add Event Subscription
14. for the Subscription name, use a name such as Standard notifications
15. Under Event notification endpoint URL, enter the URL that will be provided to you by Nectar personnel. The URL will be something similar to https://datagate-cloudagent-contoso.us.nectar.services/zoom/event. (Note: This URL must be active and reachable to continue)
16. Click + Add Events and select the following events:
    • End Meeting
    • End Webinar
    • User has been created
    • User has been deleted
    • User's profile info has been updated
17. Click Done
18. Ensure that All users in the account is selected under Event notification receiver and click Save.
    WARNING

    The event notification URL must be active to continue. If you get an "Invalid URL" error message, ensure the URL is reachable via DNS.
19. Copy the Verification Token and provide to Nectar personnel.
20. Press Continue to move to the next page. 
21. On the Add Scopes page, click + Add Scopes and add the following scopes:
    • Meeting - View all user meetings
    • Webinar - View all user Webinars
    • User - View all user information
    • Dashboard
      • View overview of usage statistics for Meetings and Zoom Rooms
      • View all users' meetings information on Dashboard.
      • View all users' webinar information on Dashboard
    • Group - View groups
22. Click Done, then press Continue to move to the next page. 
23. Once at the Activation page, all steps are complete. Copy the Installation URL and share with Nectar personnel.

In summary, provide the following information to Nectar personnel:

• Client ID
• Client Secret
• Verification Token
• Installation URL