For the complete documentation index, see llms.txt. This page is also available as Markdown.

Insights

Track WhatsApp usage and costs for each client and phone number (channel) through the 360dialog Hub, the Partner API, or webhooks. Usage can be checked regardless of whether the account is on Direct Payment or Partner Payment. Final charges always come from Meta’s monthly invoice.

There are multiple ways to check it:

View usage visually in the 360Dialog Hub

Clients and Partners can see a specific WABA usage in the Insights dashboard. To access it, click the specific WABA you want to use, then in the channel details, select Insights from the top menu.

Messages Insights

View the message breakdown according to the selected date range.

There are three categories:

  • Messages

  • Messages Breakdown

  • Costs Breakdown

Messages

It is possible to check the Total Messages count, how many were delivered, and the approximate costs.

Messages Breakdown

Total number of messages by category or country.

Using three dots, you can select the country or category and how to display the sum (total or overtime). An export option is also available.

Costs Breakdown

Total costs by category or country.

Using three dots, you can select the country or category and how to display the sum (total or overtime). An export option is also available.

The precise amount due will be determined by Meta's invoice

Please be aware that the Approximate Charges displayed in the 360Dialog Hub are financially binding in their totality. The precise amount due will be determined by Meta's invoice at the end of the month, which will serve as the authoritative record of charges

Voice Calls Insights

View the call breakdown according to the selected date range.

There are two categories:

  • Voice Calls Breakdown

  • Calls by Country

Voice Calls Breakdown

Check the Total Calls count, approximate costs, and outbound and inbound calls.

Calls by Country

Total calls by country.

Using three dots, the style can be changed. An export option is also available

Get usage programmatically per channel via API

Check the status and analysis of message usage separately using the following methods:

Get Channel Usage

Retrieve channel-level pricing analytics for messages delivered within a specific date range. This endpoint is aligned with Meta’s pricing structure and provides granular breakdowns.

Overview:

  • Returns current pricing breakdowns for a specific phone number (channel) within a WABA for any messages delivered within a specified date range.

  • Abstracts all Meta-specific complexity, so partners don’t need to implement or maintain their own integration with Meta’s pricing services.

  • Allows partners to proactively monitor pricing without needing direct integration with Meta.

  • Includes MM Lite messaging pricing and statistics

Rate Limits:

  • 10 requests/hour per phone number (channel)

  • 200 requests/hour per WABA

This endpoint offers data directly from Meta. Slight discrepancies may occur with existing info/balance endpoints due to varying usage collection and processing schedules.

Get Channel Balance

Use this endpoint to retrieve balance information only for a specific channel. Usage metrics returned by this endpoint are deprecated and will no longer be returned.

Get Client Balance

This endpoint can be used.

Rate Limits:

  • 5 requests per 30 seconds.

Via Webhook

Webhook events include message-delivery information and conversation context. You can build counters to estimate usage in real time based on those objects.

FAQ

1. Why are usage numbers different from my invoice?

Usage data in the Hub and API is based on near-real-time processing. Meta’s invoices are finalized monthly and may include adjustments. Minor differences are expected.

2. Does usage tracking work for both Partner and Direct payment accounts?

Yes. Usage tracking is available regardless of payment method. The only difference is who receives the invoice.

3. What happened to the Get client balance endpoint?

It has been deprecated and will no longer return data after July 1, 2025. Use Get channel balance for balance data and Get channel usage for usage analytics.

4. Can I still see usage per WABA or client?

Yes, but you’ll need to aggregate channel-level results from the Get channel usage endpoint across all channels within the WABA or client.

5. What is the best endpoint to use for billing dashboards?

Always use Get channel usage for accurate and detailed analytics. Combine it with Get channel balance for funds tracking.

6. Why are there different granularity options?

Granularity controls how data is grouped in time: use half_hour for high-resolution analysis, daily for regular monitoring, and monthly for summaries.

7. Are webhooks sufficient to calculate costs?

You can estimate usage from webhooks, but they are not authoritative. Always reconcile against Meta’s monthly invoice for final billing.

Last updated

Was this helpful?