iframe

Add the Betterview Geospatial UI experience to your Core System

Why?

The API allows an implementer in a core system to place orders to and retrieve data from Betterview's system. Does the core system have an advanced understanding and user interface to support the visualizations that are present in Tower? This is where the iframe solution comes into play. With minimal changes to the core system, an implementer of Betterview's API — combined with the iframe — can bring the full experience of Betterview into the core system without a user ever leaving the platform.

Examples

Place a New Order

The new request iframe is useful when providing users the utilities to validate the correct location and enter custom information into the Betterview system. From the new request iframe, a user can review the location and associated parcel boundary on a map, redraw a parcel boundary, select a product matrix, and enter in custom information like external ID, secondary ID, renewal date, premium amount, and more.

This is generally the starting place for most integrations, though it’s not always required if the goal is to provide a more automated, or streamlined, path to getting data and visuals from Betterview.

New Request

View a Property Profile

The property profile iframe provides an embedded experience of the core geospatial functionality, Betterview data and third party data that a user would expect when using the Betterview site. This iframe is always necessary when retrieving and reviewing existing Betterview property records from within an application.

View a Profile

Footprint Selection

There are instances where a policy only covers a selection of buildings at a particular address. The Betterview Footprint Selection page allows a user to identify building footprints within a parcel and select which ones are insured. On selection, the individual buildings are added into the policy, where a user can set unique coverages for each.

Footprint Selection

Implementation

Before beginning implementation, there are a few requirements to check.

  • Your organization must have access to place orders to be able to implement the iframe
  • Your organization must have been provided access to the API
  • A service account is okay for all usages within the iframe
  • For security compliance, all endpoints that serve up the iframe must be registered with Betterview. We should be able to add/modify these pretty quickly, but we’ll need to know them ahead of time before the iframe will work.

Authentication

POST http://tower.betterview.com/auth/signin/integration

Headers:

  • Authorization: Basic <base64>
    • base64 is username:password encoded as base64 string
    • username: Client org ID
    • password: An API key used specifically for the iframe integration (not your usual API key or token)
    • The username and password will be provided to you

This endpoint returns a JWT that will be used to authenticate the iframe.

Example

Obtain a Token

curl --location --request POST 'https://tower.betterview.com/auth/signin/integration' \
--header 'Authorization: Basic MTIzNDp0aGlzaXNub3RhcmVhbHBhc3N3b3Jk'

Response

{ token: 'ajwttoken' }

Basic Implementation

On pages that support the iframe solution, wire up your iframe with the JWT acquired from the authorization step in the query string.

The most notable pages that are setup to work with the iframe solution are

  • New Order: https://tower.betterview.com/property-profile/new-order?address=643+7th+st&external_id=myid&secondary_external_id=mysecondid&insured_name=Betterview&callback_url=mycallbackurl.com
  • Property Profile: https://tower.betterview.com/property-profile/:betterviewid
  • Footprint Selection: https://tower.betterview.com/embed/footprint-selection?address=4330+Wornall+Road++Kansas+City++MO+USA&callback_url=mycallbackurl.com&external_id=test

Example

<iframe src=`https://tower.betterview.com/property-profile/1?jwt=${token}`></iframe>