VETRO Integration Setup

Overview

This article will cover what VETRO FiberMap™ is, what it does, and how you can integrate VETRO with the gaiia software.

What is VETRO?

VETRO FiberMap™ is an innovative FTTx (Fiber to the “x”, where “x” denotes a premise or architecture) network mapping platform, allowing you to access and manage all of your critical data in one place.

What does VETRO do?

The integration will enable gaiia users to see updates from VETRO's fiber management software reflected in real-time, enabling enhanced functionality along with accurate data in both systems. VETRO also includes some key features:

• Single Source of Truth: gaiia keeps your OSS/BSS continuously updated with VETRO's fiber management data, allowing CSRs to access product and coverage availability instantly without the need for multiple system checks.
• Real-Time Address Validation and Product Availability: Leveraging VETRO’s API, gaiia conducts real-time address validation during the customer checkout process. This feature ensures that customers can check coverage and sign up for services immediately as network expansions are reflected in VETRO.
• Cost to Connect Display: gaiia integrates cost data from VETRO to show the connection cost at an address level directly within the CSR interface. This transparency simplifies the order acceptance process, enabling CSRs to provide accurate cost estimates and improve customer satisfaction.
• Automated Marketing for Network Expansion: As your team plans expansions in new neighborhoods, gaiia detects changes in VETRO and allows you to triggers marketing campaigns. For example, ISPs can send customized postcards with QR codes directed to a gaiia-enabled online checkout via our print partners, helping to generate customer interest and demand even before construction starts.

Getting VETRO FiberMap™ added into gaiia

There are some initial requirements that you’ll need to have before getting started with VETRO within gaiia.

• VETRO FiberMap™ OSS/BSS Bundle (Required): Have the correct bundle is very important. For additional information on enabling VETRO integrations visit VETRO Support.
• VETRO fibermap Sandbox (optional)

Once you have the requirements, you’ll have to reach out to your gaiia contact or reach out to us at support@gaiia.com to establish the link between both platforms. As a VETRO partner, we generate the token and password to connect to VETRO’s API.

How to locate the integration settings

Once gaiia has established the link between both platforms, the app will be able to be installed. To install the app, follow the below steps:

1. Click on the Integrations tab within the Admin Settings.
2. Click on Installed Apps.
3. The VETRO app should appear under the Network section with the credentials pre-populated.

Configuring Service Location settings

The Service Location settings will allow you to configure how service locations from Vetro will be synced in addresses in gaiia. Below are the steps that’ll help you complete this:

1. Within the Installed Apps from the previous section, click on the settings wheel of the VETRO app on the right-hand side.
2. Click on Service location settings tab at the top in the middle.
3. Select Add Mapping, under the Additional Fields Mapping, to link gaiia’s custom address fields to VETRO’s service location attributes.
4. Map all required fields from VETRO into gaiia.

If you have set up Custom fields in VETRO, you can map them via the integration.

Configuring Coverage area parameters

The Coverage area parameters allows you to merge together a collection of Zones from Vetro into one single Coverage area by geofence in gaiia. Below are the steps that’ll help you complete this:

1. Within the settings of the VETRO app, click on Coverage area parameters.
2. Select App mapping to set up new coverage areas.
3. Fill in the following information:
   1. Enter a Coverage area name
   2. Tie one or multiple VETRO Project ID’s to the coverage area
   3. Feature Statuses - You can also define what statuses apply to the coverage area. The statuses in the configuration will act as a filter over the zones that are imported from VETRO; zones with other statuses will not be synchronized
   4. Lastly, you can select an accuracy threshold. Coverage area is exact or not exact.
      • When identified as “not exact,” the services will be returned as “potentially available.” This could be used for upcoming areas to generate leads, or even potential areas that require a manual confirmation of serviceability. This will usually be used to have an order submitted in "request mode."
      • When identified as “exact," the services will be returned as “available.” This will usually be used to have an order submitted in “order mode.”

Benefits of mapping coverage areas: Coverage areas serve multiple purposes in gaiia, including enabling product availability by location in the online checkout or presenting a price based on the coverage area. Mapping coverage areas enables an ISP to amalgamate multiple ProjectIDs into 1 commercial layer, which can present the same price while displaying product plans with address-level accuracy. Status changes can trigger actions in gaiia including notifying your leads service has been enabled in their community or sending out demand generation material to an address to develop leads.