> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/analytics/analytics.md).

# Analytics

Dive deep into analytics with BotPengiun!

### What is Analytics

Analytics shows how your AI agents, chatbots, automations and team perform. This guide is the overview of the section. It explains the features that every page shares. Each page has its own guide.

***

### Prerequisites

* A BotPenguin account with Analytics access in your plan and your role.
* At least one AI agent or chatbot with some conversations, to see data.

***

### Key definitions

| Term          | Meaning                                                                                |
| ------------- | -------------------------------------------------------------------------------------- |
| Date range    | The period of time the whole page shows.                                               |
| Filter by     | A menu on a chart or card that limits the data to chosen AI agents, chatbots and more. |
| Key analytics | The row of cards with the main totals of a page.                                       |
| Series        | One line or bar on a chart, for example one channel.                                   |
| Chip          | A small label that shows a filter or date range you picked.                            |

***

### What Analytics gives you

Analytics shows how your AI agents, chatbots, automations and team perform. It helps you see trends, find what needs work and measure the result of changes. The section has a sidebar with one page for each topic. Every page works in the same way, so once you know the common features on this page you can read any of them.

***

### Open Analytics

1. Click **Analytics** in the left menu. The Analytics sidebar opens next to the page. Click a page in the sidebar and it opens on the right. Overview opens first.

![The pages in the Analytics sidebar](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ZLmE5yN4OnjJQMqjBcmo/images/analytics-step-1.png)

| Page         | What it shows                                                                     | What you need          |
| ------------ | --------------------------------------------------------------------------------- | ---------------------- |
| Overview     | Messages, WhatsApp, AI messages and contacts in one place.                        | Analytics              |
| Engagement   | How customers use your AI agents and chatbots: sessions, users, time and results. | Analytics              |
| Live chat    | How your team handles the chats handed over to them.                              | Analytics              |
| AI analytics | How customers rate your AI agents, what they ask and how well the agents answer.  | AI and Analytics       |
| Chat flows   | How your chatbots' chat flows are used.                                           | Analytics              |
| WhatsApp     | Messages, broadcasts, drip campaigns, templates and pricing on WhatsApp.          | WhatsApp and Analytics |

If a page is not in your plan, your partner decides whether it is hidden or shown locked. Use **Minimize** at the bottom of the sidebar to hide it, and click the arrow to show it again.

### Choose the date range

One date range works for the whole page. It stays the same when you move between tabs on the same page. It applies to every chart and card, and it overrides any change you make on one chart.

1. Click the calendar icon at the top right of the page.
2. Pick a quick range on the left: **Last 7 days**, **Last month**, **Last 6 months** or **Last year**.
3. Or pick a custom range. Click two dates on the calendars on the right. The range applies when you have picked both a start date and an end date.

![Quick ranges in the date picker](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/A6Tis50niIRUCl1z1IrD/images/analytics-step-2.png)

Good to know:

* The default is **Last 6 months**.
* The longest range is 1 year. You cannot pick a date in the future.
* When you pick another range, a small chip shows next to the calendar icon. Click the x on the chip to go back to the default.

![The chip shows the range you picked. Click the x to go back to the default](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/L2smqqlDmzZYuqQIM2FG/images/analytics-step-3.png)

### Filter a chart

Every chart has its own filter, shown as a funnel icon. The cards under Key analytics have their own filter too.

1. Click the funnel on a chart. A menu opens. **Everything** is ticked by default, which means no filter.
2. Pick a kind first, for example **AI agents**. A second panel opens with a search box and a list.
3. Tick one or more items. Use **Select all** or **Clear** if you need to. Click **Apply**.
4. The items you picked show as a small chip next to the funnel, for example "Sales Assistant" or "AI agents · 2".

![The funnel icon on a chart opens the filter menu](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/588IWDOHeAYkOj4QV15o/images/analytics-step-4.png)

A chart offers only the kinds that make sense for it: AI agents, AI chatbots, Automations, Team members, Chat flows, Status and Drip campaigns. A filter does not change the date range. The guide of each page lists the filters of each chart.

### Group by week, month or year

Charts that show data over time have a **Weekly / Monthly / Yearly** switch. There is no Daily.

* The default is Weekly when the date range is up to 12 weeks. Otherwise the default is Monthly.
* A chart shows at most the last 12 entries of the grouping you choose.
* If there is no space, the switch moves into the three-dot menu as "Show weekly", "Show monthly" or "Show yearly".
* Charts with no time on the axis have no switch: ring charts, word clouds and Visitor timing.

![The Weekly / Monthly / Yearly switch on a chart](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/hZdjJ1ynxoBcb6kbnq57/images/analytics-step-5.png)

### Download and expand a chart

Click the three-dot menu on a chart.

* **Download:** downloads a CSV file with the period and every series of that chart.
* **Expand:** opens the chart full screen over a dimmed page. Close it with the x button at the top, with the Esc key, or by clicking outside it.

![Download and Expand in the three-dot menu](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/lvnEkmkLQkoYYCQPAYh1/images/analytics-step-6.png)

![A chart expanded to full screen](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/MYg7BYz5tnrU2YXmIm4G/images/analytics-step-7.png)

### Read a chart

* **Info icon.** Every chart has an (i) icon next to its title. It says in one line what the chart shows.
* **Hide a line.** On a line chart, click the name of a line in the legend to hide it. Click it again to show it.
* **Hover.** Hover over a bar or a point to see its details in a small pop-up.

![The info icon and the legend names on a chart](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ChW80D6tt5wHJM17Z11v/images/analytics-step-8.png)

### Key analytics cards

Many pages start with a row of cards. Each card shows an icon, a number, a label and the change compared with the earlier period. Green means up and red means down. The cards have their own filter and their own Weekly / Monthly / Yearly switch. The default is Monthly. The switch decides if a card adds up the last week, the last month or the last year of your date range.

### Help and video

Use **Help** at the top right to open the help article for the page. Use the play button to watch the video.

### When there is nothing to show

* **No AI agent or chatbot yet:** you see a button to create one.
* **No channel connected:** you see a button to connect a channel.
* **No conversations in the date range:** you see a button to change the date range.

### Best practices

* Review your analytics regularly to track growth and spot problems early.
* Start with a wide date range to see the trend. Then shorten it to look into a spike or a drop.
* Use the filter on a chart to compare your AI agents or chatbots with each other.
* Check your WhatsApp analytics before your billing cycle ends, so paid conversations do not surprise you.
* Use Engagement and Chat flows together. They show session quality and flow activity.

### The Analytics pages

* Read the Overview analytics
* Read the Engagement analytics
* Read the Live chat analytics
* Read the AI analytics
* Read the Chat flows analytics
* Read the WhatsApp analytics

### Common errors

<details>

<summary>I see "No analytics yet" or an empty page</summary>

Analytics fill in after your AI agents and chatbots have conversations. If you have none, create one. If you have one but no channel, connect a channel. If both are done, change the date range, because there may be no chats in it. \[CHECK: confirm the three empty states and their buttons.]

</details>

<details>

<summary>The numbers on a card and a chart do not match</summary>

A card can add up a different time window. Check the Weekly / Monthly / Yearly switch of the card, the filter and the date range.

</details>

<details>

<summary>I cannot see a page in the sidebar</summary>

The page needs a feature in your plan. Your partner may hide it or show it locked. Your role also needs Analytics access.

</details>

<details>

<summary>Why is there no Daily view?</summary>

Charts group by Weekly, Monthly or Yearly. Pick the shortest range you need and use Weekly.

</details>

<details>

<summary>Can I pick a range longer than a year?</summary>

No. The longest range is 1 year, and you cannot pick future dates.

</details>

<details>

<summary>Does a filter on one chart change the others?</summary>

No. Each chart and each row of cards has its own filter. The date range is the only setting that applies to the whole page.

</details>

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
