Meta Business Agent Usage Insights теперь возвращает зарегистрированные данные биллинга для WhatsApp и Instagram. Endpoint показывает тарифицируемые сообщения, тарифицируемые токены и начисления одного аккаунта Business Agent за выбранный расчетный период.
Это позволяет сверять каналы, однако ответ не является прогнозом. Meta прямо указывает, что endpoint не оценивает использование, которое биллинг еще не зарегистрировал. Надежная проверка должна подтвердить полученные данные, разложить общую сумму и отдельно зафиксировать пробелы, требующие расследования.
Начните с биллингового аккаунта и часового пояса
В поле entity_id передается идентификатор биллингового аккаунта Meta Business Agent. По инструкции Meta он находится в Billing Hub, в разделе Accounts и Meta Business Agent accounts. Идентификатор номера WhatsApp, бизнес-аккаунта Instagram или приложения для этого запроса не подходит.
Запишите часовой пояс биллингового аккаунта до выбора дат. Endpoint оценивает границы периода именно в нем. Значение start включается в диапазон, а end исключается. Поэтому дневной запрос с окончанием в полночь 4 июня возвращает интервалы, начавшиеся 1, 2 и 3 июня.
Вызывающей стороне также нужно разрешение business_management. Используйте документированный Meta путь авторизации для системного пользователя или Solution Provider и проверьте принадлежность токена нужному аккаунту.
Сначала запросите общий итог без измерений
Первый запрос должен охватывать весь аккаунт и один зафиксированный период. Не передавайте dimensions, channels, sender_ids и metric_types. Тогда ответ включает все зарегистрированные метрики и оба поддерживаемых канала.

- 1АккаунтПодтвердите биллинговый ID.
- 2ГраницаИспользуйте часовой пояс и исключенный конец.
- 3ИтогПолучите все метрики без измерений.
- 4КаналРазделите WhatsApp и Instagram.
- 5ОтправительНайдите каждый объект отправки.
- 6ИсключениеОставьте пробелы открытыми.
Выберите детализацию HOUR, DAY или MONTH по цели проверки. Дневные интервалы удобны для сверки счета. Часовые помогают найти момент запуска или ошибки маршрутизации. Месячный запрос должен соответствовать правилам Meta для полных календарных месяцев.
Сохраните версию API, параметры, время получения и хеш ответа. Такой чек позволит второму специалисту повторить запрос, а не сравнивать счет с экспортом неизвестного происхождения.
Сверьте аккаунт, канал и отправителя
Повторите тот же диапазон, добавив channel в dimensions. Строки каналов должны суммироваться в неразделенный итог аккаунта по каждой возвращенной метрике. Затем добавьте sender_id, чтобы найти источник использования внутри каждого канала.
| Уровень сверки | Форма запроса | На какой вопрос отвечает |
|---|---|---|
| Аккаунт | Без измерений | Какое использование зарегистрировано для этого аккаунта и периода? |
| Канал | dimensions=channel | Какая часть относится к WhatsApp и Instagram? |
| Отправитель | dimensions=channel,sender_id | Какой отправляющий объект сформировал итог канала? |
| Исключение | Тот же диапазон и сохраненный чек | Какое расхождение требует проверки биллинга или интеграции? |
Во всех трех запросах оставьте одинаковые start, end, детализацию и набор метрик. Сдвиг границы может выглядеть как расхождение каналов, даже если каждая строка верна.
Руководство по сравнению цен ИИ-агентов объясняет коммерческие модели. У Usage Insights более узкая задача: получить зарегистрированное Meta доказательство использования для одного аккаунта Business Agent.
Не приравнивайте пустой ответ к нулевому счету
Meta определяет пустой массив usage как отсутствие подходящих биллинговых записей для диапазона и фильтров. Такой ответ не доказывает, что агент бездействовал, не обработал сообщение клиента или останется бесплатным после закрытия периода.
Сначала проверьте идентификатор аккаунта, часовой пояс, диапазон, фильтры и разрешение. Сохраните пустой ответ в журнале исключений. Если операционные журналы показывают активность, а биллинг ничего не возвращает, передайте расхождение владельцу проверки. Не заменяйте отсутствующие данные расчетной оценкой.
Некоторые поля отсутствуют из-за параметров запроса. Если metric_types исключает cost, поле стоимости пропадает из строки полностью, а не возвращается как null. Скрипт сверки должен отличать не запрошенную метрику от зарегистрированного нуля.
Сравнивайте начисления в валюте аккаунта
Значение cost возвращается в валюте аккаунта Business Agent. Сравнивайте его с Billing Hub или соответствующим счетом только после проверки аккаунта, валюты, часового пояса и периода.
Присвойте каждому запуску один из четырех результатов: совпадение, временная разница, отсутствующая биллинговая запись или необъясненное расхождение. Для каждого исключения укажите владельца и следующий шаг. После этого реестр результатов ИИ-агента может связать подтвержденную стоимость с проверенными итогами для клиентов. Сообщения и токены сами по себе не являются бизнес-результатом.
Сохраните границу интеграции
Usage Insights является endpoint Meta и не подтверждает наличие встроенного соединения в другой платформе. Если команда переносит данные в отчетную систему или процесс общего ящика, опишите пользовательский API или webhook и назначьте владельца его поддержки.
Лимит составляет 1 000 запросов в час для каждой пары приложения и биллингового аккаунта. Остановите повторные попытки после ответа 429 и примените контролируемую задержку.
До запуска нового агента выполните проверку Meta Business Agent и подтвердите карту доступности и ответственности. Биллинговые данные полезны, когда владелец аккаунта, полномочия выпуска и обработка клиента уже определены.
Часто задаваемые вопросы
Включает ли запрос Instagram, если не передавать channels?
Да. По текущей справке Meta отсутствие channels включает WhatsApp и Instagram. Добавьте измерение канала, чтобы получить отдельные итоги.
Означает ли пустой usage нулевую окончательную стоимость?
Он означает, что запрос не вернул подходящих биллинговых записей. Meta не возвращает незарегистрированное использование и расчетную стоимость.
Какой идентификатор нужен в entity_id?
Используйте идентификатор биллингового аккаунта Meta Business Agent из Billing Hub, а не номер телефона, отправителя или приложения.
Рассчитывает ли endpoint ROI агента?
Нет. Он дает зарегистрированное использование и начисления. Для ROI нужны проверенные результаты клиентов, сравнение и остальные операционные расходы.
Источники
Помочь применить это руководство?Спросить команду DripTell
От чтения к действию
Нужна помощь с применением этого подхода в вашей компании?
Оставьте контакты. Мы учтём материал, который вы читаете, и начнём с полезного ответа для вашей команды.
DripTell Editorial
Практические материалы, проверенные командой продукта и клиентских процессов DripTell.
Узнайте, как DripTell проверяет сведения о продукте, использует первичные источники и исправляет ошибки.
Редакционная политика и источники



