Meta Business Agent Usage Insights kan nu geregistreerde facturatiegegevens voor WhatsApp en Instagram teruggeven. Het endpoint rapporteert factureerbare berichten, factureerbare tokens en kosten voor één Business Agent-account over een gekozen facturatieperiode.
Daarmee kun je kanalen afstemmen, maar de respons is geen prognose. Meta schat geen gebruik dat nog niet door facturatie is geregistreerd.
Begin met het factureeraccount en de tijdzone
De aanvraag gebruikt het ID van het Meta Business Agent-factureeraccount als entity_id. Volgens Meta staat dit in Billing Hub onder Accounts en Meta Business Agent accounts. Gebruik hier geen WhatsApp-telefoonnummer-ID, Instagram-bedrijfsaccount-ID of app-ID.
Leg de tijdzone van het factureeraccount vast. Het endpoint beoordeelt de grenzen daarin. start is inclusief en end exclusief.
De aanroeper heeft ook de toestemming business_management nodig. Volg Meta's gedocumenteerde autorisatiepad voor een systeemgebruiker of Solution Provider en controleer of het token bij het juiste account hoort.
Haal eerst één totaal op zonder dimensies
Begin met één aanvraag op accountniveau voor de gekozen periode. Laat dimensions, channels, sender_ids en metric_types weg. De respons bevat dan alle geregistreerde statistieken en beide ondersteunde kanalen.

- 1AccountBevestig het factureeraccount-ID.
- 2GrensGebruik accounttijdzone en exclusief einde.
- 3TotaalHaal alle statistieken zonder dimensies op.
- 4KanaalSplits WhatsApp en Instagram.
- 5AfzenderVind iedere verzendende entiteit.
- 6UitzonderingHoud ontbrekend bewijs open.
Kies HOUR, DAY of MONTH op basis van het onderzoek. Maandaanvragen moeten voldoen aan Meta's regels voor volledige maanden.
Bewaar API-versie, parameters, ophaaltijd en responshash zodat een tweede beoordelaar de aanvraag kan herhalen.
Stem account, kanaal en afzender op elkaar af
Voer hetzelfde datumbereik opnieuw uit met channel in dimensions. De kanaalregels moeten per statistiek optellen tot het onverdeelde accounttotaal. Voeg daarna sender_id toe om het gebruik binnen ieder kanaal te herleiden.
| Controlemiveau | Aanvraagvorm | Vraag die wordt beantwoord |
|---|---|---|
| Account | Geen dimensies | Welk gebruik is voor dit account en deze periode geregistreerd? |
| Kanaal | dimensions=channel | Welk deel hoort bij WhatsApp en Instagram? |
| Afzender | dimensions=channel,sender_id | Welke verzendende entiteit vormde het kanaaltotaal? |
| Uitzondering | Hetzelfde bereik en opgeslagen bewijs | Welk verschil vraagt om facturatie- of integratieonderzoek? |
Gebruik voor alle drie aanvragen dezelfde start, eindtijd, granulariteit en statistiekenset. Een andere grens kan op een kanaalverschil lijken terwijl elke afzonderlijke regel klopt.
De vergelijking van AI-agentprijzen behandelt commerciële prijsmodellen. Dit endpoint heeft een smallere taak: Meta's geregistreerde gebruiksbewijs voor één Business Agent-account ophalen.
Behandel lege en ontbrekende gegevens zorgvuldig
Meta definieert een lege usage-array als geen overeenkomende facturatieregels voor het aangevraagde bereik en de filters. Dat bewijst niet dat de agent inactief was, geen klantbericht behandelde of bij de eindafrekening gratis blijft.
Controleer eerst account-ID, tijdzone, bereik, filters en toestemming. Bewaar de lege respons in het uitzonderingslogboek. Als operationeel bewijs activiteit toont terwijl facturatie niets teruggeeft, escaleer je het verschil. Vul de ontbrekende gegevens niet met een eigen schatting.
Velden kunnen ook door de aanvraagvorm ontbreken. Als metric_types de waarde cost uitsluit, wordt het kostenveld volledig uit de regel weggelaten. Er komt geen null terug. Een controlescript moet een niet-opgevraagde statistiek onderscheiden van een geregistreerde nul.
Vergelijk kosten in de valuta van het account
De waarde cost gebruikt de valuta van het Business Agent-account. Vergelijk die waarde pas met Billing Hub of de bijbehorende factuur nadat account, valuta, tijdzone en periode zijn bevestigd.
Leg per controle één van vier uitkomsten vast: passend, timingverschil, ontbrekende facturatieregel of onverklaard verschil. Zet een eigenaar en volgende controle bij iedere uitzondering. Het AI-agentresultatenboek kan bevestigde kosten daarna aan gecontroleerde klantresultaten koppelen. Berichten en tokens zijn op zichzelf geen bedrijfswaarde.
Houd de integratiegrens zichtbaar
Usage Insights is een Meta-endpoint en bewijst geen ingebouwde verbinding in een ander platform. Als een team deze gegevens naar rapportagesoftware of een proces in een gedeelde inbox exporteert, documenteer dan de aangepaste API- of webhookconfiguratie en de beheerder ervan.
Het endpoint staat 1.000 aanvragen per uur toe voor iedere combinatie van app en factureeraccount. Stop herhaalde pogingen bij 429 en gebruik gecontroleerde vertraging.
Voer vóór de activering van een nieuwe agent de Meta Business Agent-lanceringstest uit en bevestig de kaart voor geschiktheid en eigenaarschap. Facturatiebewijs helpt pas wanneer accounteigenaarschap, releasebevoegdheid en klantafhandeling duidelijk zijn.
Veelgestelde vragen
Wordt Instagram meegenomen als het kanaalfilter ontbreekt?
Ja. Meta's huidige referentie zegt dat het weglaten van channels WhatsApp en Instagram omvat. Voeg de kanaaldimensie toe voor afzonderlijke totalen.
Betekent een lege usage array dat de eindkosten nul zijn?
Het betekent dat voor die aanvraag geen passende facturatieregels zijn teruggegeven. Meta levert geen ongeregistreerd gebruik of geschatte kosten.
Welk ID hoort in entity_id?
Gebruik het Meta Business Agent-factureeraccount-ID uit Billing Hub, niet een telefoonnummer, afzender of app-ID.
Kan het endpoint het rendement van een AI agent berekenen?
Nee. Het levert geregistreerd gebruik en kosten. Rendement vraagt om bevestigde klantresultaten, een vergelijking en alle overige operationele kosten.
Bronnen
Hulp nodig bij deze handleiding?Vraag het DripTell-team
Van lezen naar doen
Hulp nodig om dit voor jouw bedrijf toe te passen?
Laat je gegevens achter. We nemen dit artikel als context en beginnen met een bruikbaar antwoord voor je team.
DripTell Editorial
Praktische uitleg, gecontroleerd door het product- en klantworkflowteam van DripTell.
Lees hoe DripTell productclaims controleert, primaire bronnen gebruikt en correcties verwerkt.
Redactioneel en bronnenbeleid



