# Get insights about conversation movement with the Flow Heatmap

We know how essential data is for improving your conversational flows. The Flow Heatmap gives you detailed insights into how conversations move through your flows, allowing you to identify error-prone steps, see which steps result in high user abandonment rates, and understand the most and least used conversational routes. Use these insights to optimize your flows, increase conversions, and create a great user experience!

&#x20;

#### In this article:

* [How to find Flow Heatmap data](#h_01F6S0TR6XRB8JRGP3MNS0RXPS)
* [How to filter and customize Flow Heatmap Data](#h_01F6S0V130QPG7W5GCNF5RSCKJ)
* [Types of Flow Heatmap insights and how to interpret them](#h_01F6S0VB99FSRX6XXWXSWZNZ9M)

&#x20;

<figure><img src="/files/HII5I5mwp8r7H2mg3ZJ3" alt=""><figcaption></figcaption></figure>

&#x20;

## How to find Flow Heatmap data <a href="#h_01f6s0tr6xrb8jrgp3mns0rxps" id="h_01f6s0tr6xrb8jrgp3mns0rxps"></a>

To be able to see the heatmap data for a flow, the flow needs to be published and have had at least 1 conversation or ‘invocations’ run through it. Of course, the more conversations the flow has completed, the better the data will be!

There are three ways that you can access a flow’s heatmap:&#x20;

* From the Flow Builder overview page
* From a flow’s setup page
* From a flow’s logs

### From the Flow Builder overview page

<figure><img src="/files/XjdtNwRMbQhPx3MGP8vs" alt=""><figcaption></figcaption></figure>

First, make sure you’re logged into your [MessageBird Dashboard](https://dashboard.messagebird.com/), then navigate to [Flow Builder](https://dashboard.messagebird.com/flow-builder). To jump straight to a flow’s heatmap, click the **Heatmap** icon on the flow card.

&#x20;

### From a flow’s setup page

<figure><img src="/files/K4izBfuQyNNlFKCbHM7a" alt=""><figcaption></figcaption></figure>

If you’re already working in a flow,  click the cog icon and select **Heatmap** from the menu.

&#x20;

### From a flow’s logs

<figure><img src="/files/Xu379Psg2asp63weF3qM" alt=""><figcaption></figcaption></figure>

If you’re working in a flow’s logs, click on the **Flow Heatmap graphic**.

&#x20;

### From a specific invocation's logs

Sometimes you'll need to focus on a specific invocation to fully understand an individual user's journey. To access the heatmap for a specific invocation, click the heatmap icon next to the invocation that you want to explore.

<figure><img src="/files/THtisgttNT2AuopcKOF2" alt=""><figcaption></figcaption></figure>

&#x20;

## How to filter and customize Flow Heatmap Data <a href="#h_01f6s0v130qpg7w5gcnf5rsckj" id="h_01f6s0v130qpg7w5gcnf5rsckj"></a>

<figure><img src="/files/h3eLHzX8I1yFNr7eOADt" alt=""><figcaption></figcaption></figure>

&#x20;

As you create more iterations, add extra steps, and increase the amount of traffic moving through a flow, the data that appears in your heatmap will also become more complex. Filtering your heatmap will allow you to focus on the data that you need.&#x20;

&#x20;

### Filter by date range

<figure><img src="/files/AWkw8EnWJM9RgGFkkwpV" alt=""><figcaption></figcaption></figure>

The simplest way to get started with filtering your data is to select the period of time that you would like to analyze.&#x20;

To do this, click on **Data filters** and select a date range. Your heatmap will automatically update to show you data from the date range that you have selected.

&#x20;

### Filter by version

<figure><img src="/files/6i9JfbirIPx6ooVfK3o0" alt=""><figcaption></figcaption></figure>

Filtering your heatmap data by version is a great way to understand how changes you’ve made to your flow has affected error rates, abandonment rates, and conversational routes.&#x20;

To do this, click **Select version** and choose a version from the list that appears. Every version of your flow will be saved to this list, so we’ve clearly labeled the versions that were live.

&#x20;

### Customize heatmap layers

<figure><img src="/files/0Vp6qIDlB6KuLlUQzMrd" alt=""><figcaption></figcaption></figure>

If you have a particularly complex flow with a lot of traffic moving through it, your heatmap might be too complex to understand at a glance. Layers allow you to simplify the heatmap by customizing the visible data.

To do this, click on the **Heatmap layers** icon at the bottom left-hand corner of the screen. By default, all options are visible. To de-select options and clean up your heatmap, just untick the box next to the type of data you want to hide. Use this tool to hide or unhide incoming, successful, failed, or expired traffic data, or to show or hide label and line elements.&#x20;

&#x20;

### Drill down into specific steps and branches

<figure><img src="/files/WbNbRUjFy67rVsumN4YI" alt=""><figcaption></figcaption></figure>

Do a deep-dive into specific steps and branches by clicking on them in your flow. Any available traffic data will be displayed. This will allow you to see insights such as which routes are most and least popular with your customers and is particularly useful if your flow contains multiple branches!

&#x20;

### Get real-time insights with Live data

<figure><img src="/files/DSaIRcFA4CNZGykWZysH" alt=""><figcaption></figcaption></figure>

To see analytics data “as it happens”, toggle the **Live data** switch to ON. When switched on, the heatmap data will refresh every 10 seconds. This is useful in situations where you’re rolling out a new version of your flow and would like to monitor the impact of your changes on your user experience in real-time.

&#x20;

## Types of Flow Heatmap insights and how to interpret them <a href="#h_01f6s0vb99fsrx6xxwxswznz9m" id="h_01f6s0vb99fsrx6xxwxswznz9m"></a>

The Flow Heatmap will show you three types of information:

* The errors report
* The expiration report
* Additional traffic from flow loops

### The errors report

<figure><img src="/files/0Z5Kf4ggq4VBYdplVsc2" alt=""><figcaption></figcaption></figure>

Error data is displayed in red and shows you the number of errors that occurred at each step, and the error rate of the step. If no errors have occurred at a step, no information is displayed.

Click on the information to see a more detailed breakdown.

<figure><img src="/files/K4wJUSPTGKUaAlioApsM" alt=""><figcaption></figcaption></figure>

#### &#x20;

### The expiration report&#x20;

<figure><img src="/files/5cA9TFJcxg15TJ3qYvR1" alt=""><figcaption></figcaption></figure>

Expiration data is displayed in black and shows you how many people abandoned the flow at a particular step. If no abandonments have occurred, no information is displayed.

#### &#x20;

### Additional traffic from flow loops

<figure><img src="/files/KQYIWKP8RGGmNZZCFTLD" alt=""><figcaption></figcaption></figure>

If your flow contains ‘jumps’ or ‘loops’ where traffic skips steps, this traffic will be displayed in green as additional traffic. The exact amount of additional traffic will be displayed at the source of the jump.

&#x20;


---

# 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://docs.bird.com/connectivity-platform/build-and-manage-a-flow/get-insights-about-conversation-movement-with-the-flow-heatmap.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.
