Zuper - Hover

​

Overview

The Zuper and Hover integration empowers roofing service teams to manage property measurements seamlessly without leaving the Zuper platform. With this integration, you can: ✅ Order a new measurement directly from a Zuper job. ✅ Sync existing Hover projects to Zuper jobs. ✅ View, edit, and download measurement data. ✅ Access 3D model via Hover. ✅ Track all measurements in Zuper’s job activity.   This integration enhances accuracy, visibility, and efficiency across your roofing workflow — from measurement to execution.

​

Zuper Prerequisites

• You must have admin access or permissions to edit custom roles and job settings.
• Ensure your settings workspace is set up with the Jobs module enabled.
• For integrations, you’ll need credentials from the external provider.
• The customers with Core and Premium plans on Zuper will have access to Hover.

​

Custom Roles

You need to enable the permission in a custom role to allow users to order measurements from external providers.

1. Navigate to Users & Teams > Custom Roles.
2. Click New Role or edit an existing one.
3. Enter a Role Name (e.g., “Roofing Technician”) and Description.
4. Select the Jobs module from the List of Modules under Permissions.
5. Search for Order Measurements from External Provider in the Jobs Permissions section.
6. Toggle the switch to On (it will turn blue).
7. Review and enable other related permissions: Click Save Role to apply changes.
8. Assign this role to relevant users or teams.

Once set, users with this role can initiate measurement orders from job details.

​

Managing Measurement Tokens

Measurement tokens define the specific data points (e.g., lengths, areas) that Zuper pulls from external providers. You can enable or disable these to tailor what appears in your job reports.

1. Go to Job Settings > Measurements > Tokens.
2. Under Measurement Tokens, you’ll see a list categorised by type (e.g., Roof Measurement).
3. For each token, toggle the switch to enable or disable the applicable tokens.
4. Search for specific tokens using the search bar.
5. Changes are saved automatically.

​

Connecting to Measurement Providers

Zuper supports integrations with leading roof measurement services to fetch data like aerial-derived roof specs, 3D visualisations, and high-precision reports.

1. Navigate to Job Settings > Measurements > Providers.
2. You’ll see a list of available providers: The providers will have a list of measurement providers. Click “Hover.”
3. Click “Connect” to redirect to the Zuper App Store. Follow the steps to authenticate and link your account.

4. Click “Notify” to be notified when the new app is launched.

• If your preferred provider isn’t listed, scroll to Request Integration. To submit the request, you must fill out the form.
  • Enter details about the provider.
  • Click Submit Request for evaluation by the Zuper team.

​

How to Enable the Hover Integration?

1. Log in to your Zuper app, click the “User” icon, and tap on the “App Store”.

2. Under the “Browse by Category,” select the “Measurements & Estimations” option and choose “Hover.”

3. On the Hover app page, click “Install Hover.”

4. You will be redirected to Hover for authentication. Click “Allow” to authenticate.
   Note: Only Hover Administrators can complete the authentication.
   

​

How to Generate a Zuper API Key

You need a Zuper API Key to complete Hover setup: Zuper API Keys are essential for securely authenticating and authorising access to the Zuper API. These keys enable seamless integration with Zuper’s services, allowing developers to build robust applications that leverage real-time data and functionality.

1. From the settings, select “Developer Hub,” choose “API Keys,” and click “+New API Key.”

2. A “New API Key” dialog box appears. Enter the “API Key Name.” Click the “Create” button to generate the API key.

3. The API key is successfully created. Click the copy icon to copy the API key. Paste it into the Hover configuration settings in Zuper

4. Under “Actions,” you can view or delete the API key.

5. Click Configure Settings in the left panel of the Hover app page. Enter your Zuper API Key. Click “Update.”

✅ Your Hover integration is now active and ready to use!

​

How to Order a New Hover Measurement?

• From any job in Zuper, you can request a new measurement:
• Open the Job Details page. Go to the Measurement tab.
• Click Order New Measurement (top-right).

You’ll see two options:

​

Option 1: Create New Measurement

Fill in the following details:  Project Name - By default, this field is automatically populated with the Zuper Job Title (the name you assigned when creating the job, e.g., “Smith Residence – Roof Replacement”).  Capture By - Choose who will capture the property images: Capture By – Choose who will capture the property images in Hover:

• Field Executive
  • Auto-fills with the assigned field executive’s name, email, and phone number.
  • Use this if your on-site crew will capture images through the Hover app.
• Homeowner
  • Auto-fills with the customer’s contact information stored in Zuper.
  • Helpful when you want the homeowner to take their own property photos through Hover.
  • The homeowner will receive an email/text invitation to capture images directly from their device.
• Professional
  • Manually enter the contact information of another professional (e.g., subcontractor or estimator).
  • Use this if someone outside your team will handle the image capture.
• Deliverable Type – Defaults to “Roof Only.”
• Service Address - Pulled from the Zuper job. Editable if corrections are needed.

✅ After reviewing all fields, click Submit.
The new measurement request will appear in the Measurement tab as In Progress.

​

Option 2: Select an Existing Project

If you’ve already created a Hover project for the property, you can link it instead of starting fresh: 1.     The service address auto-fills in the search bar. 2.    Hover displays all matching projects for that address. 3.    Select the desired project. 4.     It instantly syncs with the Zuper job.

• Select the desired project, which syncs instantly to your Zuper job.

​

Viewing Synced Measurements

When Hover measurements are available, it automatically syncs to Zuper: Once measurements are synced back from Hover, you can view and manage them in Zuper. Viewing Synced Measurements

• Go to the Measurement tab.
• Click the Completed Measurement Card.
• Review synced values mapped to Zuper’s standard measurement tokens.

Viewing Visual Assets

• PDF Reports: View inline within Zuper.
• 3D Models: Click View → opens in Hover (login required).

Edit the synced measurements.

• Click the ✏️ Edit icon or open the ⋮ menu → Edit.
• Make your changes and save.
• Edited fields display an “Edited” label.
• All edits are logged in Job Activity.

​

Viewing and Managing Measurements

Downloading Files

• Open the ⋮ menu on the Measurement Card and Download.
• Save the complete Hover measurement package locally.

​

Removing Measurements

• Open the ⋮ Menu → Remove.
• Confirm removal.
• Measurement is unlinked from the job, and the action is logged in Job Activity.

• Click the “Gallery” tab to view all the measurement pictures.

• Click the “Activity” tab to view all the measurement-related activities.

​

How to Uninstall Hover from Zuper?

1. Click on your Profile Picture in the top right corner of the screen and select the “App Store.”

2. Under the “Browse by Category,” select the “Measurements and Estimations” option and choose “Hover.”

3. Click the “Deactivate” button.

4. Click “Deactivate” to confirm.

5. Click the “Uninstall App” button.

6. Hover is uninstalled successfully.

​

❓ Frequently Asked Questions (FAQs)

Q1: Who can install and configure the Hover integration in Zuper? Only Zuper users with Admin privileges can install apps from the App Store. Additionally, the user must be an Administrator in Hover to authenticate during setup.   Q2: What happens if I enter the wrong API key or email during configuration? The integration will fail to sync data. Go back to Settings → App Store → Hover → Configure Settings to correct the details and click Save. You will receive an error to recapture the measurements.   Q3: Can I link multiple Hover projects to a single Zuper job? You can link multiple Hover measurement projects to a single Zuper job.   Q4: Why don’t I see my existing Hover project when searching? Ensure: The service address in Zuper matches the address in Hover (including unit/apt #). You’re logged into Hover with an account with access to that project. Q5: Are edits made in Zuper synced back to Hover? No. Edits in Zuper are local only and do not update the original Hover project.   Q6: What if a measurement stays “In Progress” for too long? You need to reach out to Hover support.   Q7: Can Field Executives order measurements, or only admins? Admins and users with custom role access can order measurements.   Q8: Will removing a measurement in Zuper remove it in Hover? No. Removing a measurement in Zuper only unlinks it from the job. The project remains intact in Hover and can be re-linked later if needed.   Q9: Where can I view the 3D model of the roof? Click View on the Measurement Card, which opens the full 3D model in your browser via the Hover platform. You must be logged into Hover to view it.