Skip to main content

How to track your contract usage in the Usage report

  • Updated

  1. Introduction

  2. Audience and purpose

  3. How to access

  4. Navigating the sidebar

  5. General filters

  6. Contract overview

  7. Metric detail pages

  8. AI Token usage

  9. WhatsApp message usage

  10. Step-by-step guide

  11. Frequently Asked Questions

  12. Metrics glossary

 

Introduction

The Usage report brings together, in one place, the usage of your contract metrics with Blip throughout the month. With it, you can track how much has already been used, how this usage was distributed among your routers, bots, and WhatsApp numbers, and on which days it was concentrated.

Before you begin

  • Restricted access: the report is available only to contract administrators.

  • Custom metrics: the metrics displayed depend on what was purchased. Therefore, your contract screen may differ from another contract's screen. This is expected.

  • Analysis period: data is presented by month. A month's closing data becomes available within 5 business days after the last day of that month.
     

Audience and purpose

This report is intended for administrators, managers, and finance teams responsible for monitoring the contract, allowing them to:

  • Track usage for the current month and anticipate the need for adjustments.

  • Identify which routers, bots, flows, or phone numbers account for the most usage.

  • Locate usage peaks and relate them to campaigns, sends, or operational events.

  • Understand the composition of WhatsApp messages, distinguishing between paid and free messages and by category.

 

How to access the Usage report

  1. In the Blip Portal, access the Contract dashboard.

  2. In the Plan monitoring section, click Usage report.

Contract dashboard with the “Usage report” card highlighted in the “Plan monitoring” section.

Important: if you cannot see the Usage report card, check whether you have administrator permissions for the contract.

 

Navigating the sidebar

The sidebar on the left organizes the report by usage type. The items displayed vary according to your contract's metrics, but always follow the same logic:

Item What you find Availability
Overview: Usage report Summary of usage for all contract metrics during the selected period. All contracts

Metric usage pages

Example: Details of your metric usage, AI Token usage, DEU usage, and so on

 A page with details for each contracted metric or group of metrics. According to the contract metrics
WhatsApp conversation usage Messages delivered through WhatsApp, separated into paid and free messages, by category, phone number, and day. All contracts

Usage report sidebar, with Overview selected.

 

General filters

  • Period: in the upper-right corner of each page, select the month you want to analyze. The filter applies to all sections on the page.

  • WhatsApp account (WABA): available on the WhatsApp conversation usage page, this allows you to select the WhatsApp Business account to be analyzed.

 

Section 01: Contract overview

The Overview is the first page of the report. It is organized into sections, and each section corresponds to a metric or group of metrics in your contract.

The sections displayed depend on your contract's main user metric (MAU, MEU, DEU, or DAU), along with the message and additional metrics included in it. The WhatsApp messages section appears for all contracts.

How each section is organized

Element What it shows
Title and period Metric name and period considered: from the first day of the month through the current date, or the complete month when it has already ended.
Description and “Learn more about the terms” Summary of what is being measured, with a link that opens the definition of the section's metrics. See Details of usage terms.
Current usage Cards showing the volume used for each metric during the period.
Trend chart Usage distribution throughout the month, by day or week, according to the metric.
Supporting indicators When available: current month's volume, average weekly usage, and the week of the month with the highest usage.
View more Takes you to the metric detail page, which is also accessible from the sidebar.

In the example below, the Plan usage section contains the Total DEU volume, Additional DEU MKT/Prospect, Additional AI, and Active Messages cards, followed by the Engaged conversations chart, which shows the daily evolution of these metrics during the month.

Details of usage terms

To understand what each metric means without leaving the report, click Learn more about the terms in the section description. The Details of usage terms modal opens with a list of the metrics displayed in that section.

  • Click a metric name to expand its definition.

  • Click Close to return to the report.

The metrics listed in the modal match the metrics in your contract. Therefore, the content may vary from one contract to another. You can also find all definitions in the Metrics glossary at the end of this article.

“Details of usage terms” modal with the DEUs, Additional DEU MKT/Prospect, Additional AI, and Active Messages metrics.
 

WhatsApp messages section

This section is present in all contracts and provides two views:

  • Message usage: total messages during the period, separated into paid messages and free messages. Free messages are divided by origin: Free entry point and Free customer service.

  • Message origin: weekly evolution of delivered messages, comparing paid and free messages, with totals for delivered, paid delivered, and free delivered messages.

“WhatsApp messages” section in the Overview.

 

Section 02: Metric detail pages

When you click View more in an Overview section, or an item in the sidebar, you access the metric detail page. All detail pages follow the same structure:

1. Period summary

Shows the analyzed period and a card for each metric, with the volume used during the period.

2. Usage by source

Table showing how much each router, bot, or flow used, according to the analyzed metric. Use this view to identify which operations account for the most contract usage.

3. Daily count

Table showing each metric's usage day by day. Use this view to locate usage peaks and relate them to campaigns, sends, or operational events.

The tables include one column for each metric and have configurable pagination: choose how many items to display per page and navigate between pages.

Detail page with the period summary, usage-by-router/bot table, and daily count.

 

Section 03: AI Token usage

If your contract includes artificial intelligence features, the report provides a dedicated view of AI Tokens, the unit used to measure artificial intelligence resources in platform modules.

  • Total tokens used: volume used during the selected period.

  • Usage by flow or router: table with the total number of tokens used by each flow or router. Use this view to identify which AI experiences account for the most usage.

  • Daily usage: table with the total number of tokens used each day of the period, to locate usage peaks.

“AI Token usage” page with the total number of tokens, the flow-or-router table, and daily usage.

Tip: if you notice a token usage peak on a specific day, compare the daily count with the flow-or-router table to identify which AI experience caused the increase.
 

Section 04: WhatsApp message usage

The WhatsApp conversation usage page follows the same structure as the other detail pages and is available for all contracts.

Important: the values on this page are received directly from WhatsApp and may differ from those shown on the invoice. Use this report only as an estimate of your usage.

Period summary

Select the WhatsApp account (WABA) and track three totals:

  • Delivered messages, with details by Meta category.

  • Paid delivered messages, with details by Meta category.

  • Free delivered messages, with details by origin: Free entry point and Free customer service.

Phone numbers

Table showing the usage of each phone number in the account, distributed by message category and with the total for each number. Use the Paid messages and Free messages tabs to switch between views.

Daily message count

Table showing usage day by day, distributed by message category. It also includes the Paid messages and Free messages tabs.

Messages initiated by the company are classified by Meta into the categories Utility, Authentication, Marketing, Marketing Lite, or Service. To learn more about each category, see the official Meta documentation.

“WhatsApp messages” page with the summary, phone number table, and daily count.

 

Step-by-step guide to tracking usage

  1. In the Blip Portal, access Contract dashboard › Usage report.

  2. Select the period you want to analyze.

  3. In the Overview, check the current usage of each contract metric.

  4. Review the trend chart and supporting indicators to understand when during the month usage was concentrated.

  5. Click View more to open a metric detail page.

  6. In the usage by source table, identify which routers, bots, or flows used the most.

  7. In the daily count, locate peak days and relate them to your operational activities.

  8. If your contract includes AI, access AI Token usage to see which flows or routers used the most tokens.

  9. Access WhatsApp conversation usage to check paid and free messages by category, number, and day.

 

Frequently Asked Questions (FAQ)

1. Why do I see different metrics from another contract?

The metrics displayed in the report depend on what was purchased. Each contract has a main user metric (MAU, MEU, DEU, or DAU) and may include message, AI, and additional metrics. Therefore, the sidebar and Overview sections may vary from one contract to another.

2. I believe a metric from my contract is missing. What should I do?

If you cannot find a business metric from your contract in the usage dashboard, contact your Blip account manager: CSM, Account Manager, or Accredited Partner.

3. When does the month's closing data become available?

A month's closing data becomes available within 5 business days, counted from the last day of that month.

4. I can't see the Usage report. What should I do?

The report is available only to contract administrators. If you need access, ask an administrator.

5. Can the same user be counted more than once?

Yes. User metrics (DAU, DEU, MAU, and MEU) are counted by main bot (router). If the same user interacts with two routers, for example, two different WhatsApp numbers, they are counted once for each.

6. What time is used to count a day?

The accounting day's update follows the time zone defined in your Blip Portal.

7. What makes a WhatsApp message free?

A delivered message is free when it is sent within the 24-hour customer service window or the 72-hour free entry point window. 

 

Metrics glossary

Below, see the definition of each metric that may appear in your Usage report. You will see only the metrics included in your contract.

Users

All user metrics are counted by main bot (router): if the same user communicates with two routers, for example, two WhatsApp numbers, they are counted once for each.

Metric Meaning Who is counted Counting period
DAU Daily Active User
Daily Active User 		Distinct user who sent or received any message (text, image, document, video, click, or quick reply). Day (12:00 a.m. to 11:59 p.m., Brasília time)
DEU Daily Engaged User
Daily Engaged User 		Distinct user who interacted with the bot in any way (message, reply, click, audio, emoji, quick reply, and so on), on any channel (WhatsApp, RCS, Blip Chat). Day (12:00 a.m. to 11:59 p.m., Brasília time)
MAU Monthly Active User
Monthly Active User 		Distinct user who sent or received any message. Month
MEU Monthly Engaged User
Monthly Engaged User 		Distinct user who interacted with the bot in any way, on any channel. Month

Active or engaged? An active user (DAU, MAU) is counted even if they only received a message. An engaged user (DEU, MEU) is counted only when they interact with the bot.

Additional metrics

Metric Definition
Additional DEU MKT/Prospect DEU triggered by a marketing template, Click-to-WhatsApp, Click-to-RCS, ads on Google, Meta, or TikTok platforms, as well as QR codes and external links in general.
Additional AI DEUs that triggered artificial intelligence events in Studio.

Messages

Metric Definition
Active messages All messages sent through an active send during the period, regardless of whether the user interacted or replied, except those that failed.
Messages processed All messages (text, image, document, click, emoji, and so on) sent or received during the period.

Artificial intelligence

Metric Also appears as Definition
Total tokens used Token volume (Overview) Total tokens used during the period. A token is the unit used to measure artificial intelligence resources in platform modules.

WhatsApp messages

Definitions provided by Meta.

Metric Type Definition
Delivered messages Total Messages sent by your company that reached the recipient's device. Does not include undelivered messages, such as when the device was out of service.
Paid delivered messages Paid Messages charged for and successfully delivered. They may be marketing, utility, or authentication messages.
Free delivered messages Free Messages delivered without charge because they were sent within a free window (customer service or free entry point).

Message categories

Categories displayed Where to learn more
Marketing · Marketing Lite · Utility · Authentication · Authentication – international · AI Provider · Service Classification and billing rules are defined by Meta. See the official WhatsApp Business Platform pricing documentation.

Supporting indicators

They appear alongside the charts and apply to any metric.

Indicator Definition
Current month's volume Total metric usage since the beginning of the selected month.
Average weekly usage Average metric usage per week in the selected month.
Week with the highest usage Week of the selected month in which the metric had the highest volume.

Analysis dimensions

Dimension What it represents Where it appears
Router/bot The contract's main bot to which usage was attributed. Metric detail pages
Flow Flow or router that used AI tokens. AI Token usage
Phone number WhatsApp number for the selected account. WhatsApp conversation usage
Date Day on which usage was recorded. All daily count tables


 

Need more help? Explore our content on Blip Academy or Blip Community, watch tutorials on our YouTube channel or ask questions through our support channel 😃

Related articles