# Valuation Widget

### Overview

The widget can capture leads by auto-filling vehicle information, asking key questions and making a conditional offer informed by your preset valuation strategy.

It is highly customisable to your dealership brand or corporate imagery requirements, feeling at home on your existing website. 

The resulting leads are deployed over email or select LMS providers depending on your region.  

### Example Implementations

You can find an example of the valuation widget operating on the[ AutoGrab corporate homepage here](https://autograb.com.au/). For a more brand / corporate imagery-compliant implementation refer to [Berwick Jeep](https://www.berwickjeep.com.au/used-cars/sell-my-car/)

### Implementation

Speak to your sales rep about your desired implementation pattern. We will supply you with staging and production iFrame url code as part of your deployment process. 

### Position On Page

You have two options to embed the iframe inside your website. In both these options, it is critical that you set the iframe width to 650px and centred.

**Popup** - holding the iframe in a popup container and ensuring you conform to the `AUTOGRAB_VALUATION_HIDE` to event listening to close the popup container and `AUTOGRAB_VALUATION_DIMENSIONS` resize the height dynamically.

**On Page** - holding the iframe on a page ensuring you let us know so we can remove the close button. Since the page can still extend vertically you need to respond to the `AUTOGRAB_VALUATION_DIMENSIONS` alert.

### Event Listeners

{% hint style="info" %}
Please ensure your implementation meets the minimum event listener requirements. 
{% endhint %}

The valuation widget will send messages you need to pay attention to via the iframe postMessage function. The messages are as follows.

`AUTOGRAB_VALUATION_SUCCESS`

The widget loaded successfully, no intervention is needed.

`AUTOGRAB_VALUATION_ERROR`

There was an exception or error delivering the iframe contents.

`AUTOGRAB_VALUATION_HIDE`

The close button at the end of the workflow or close X in the interface has been pressed.

`AUTOGRAB_VALUATION_DIMENSIONS`

The iframe has resized due to changed in the contents. Please respond by resizing the iframe container to hold the new contents without cropping. 

`AUTOGRAB_VALUATION_COMPLETE`

The valuation widget has created a lead. Monitor this event with your analytics product to denote a successful lead conversion. 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devhub.autograb.com/embeddable-products/valuation-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.