WhatsApp-statistieken

De Metrics-pagina onder WhatsApp → Metrics laat zien hoe je WhatsApp-verzendingen presteren over de hele werkruimte. Gebruik het WhatsApp-log om een enkel bericht te controleren. Voor de pagina heeft je werkruimterol zowel leesrechten voor WhatsApp als leesrechten voor analytics nodig.

Je statistieken lezen

Bereik, scope en tabbladen

• Outbound / Inbound: het tabblad Outbound toont berichten die je hebt verzonden. Het tabblad Inbound telt berichten die je nummers hebben ontvangen, in totaal en per nummer.
• Bereik: laatste 24 uur, 7, 30 (standaard) of 90 dagen. Je kunt ook over een grafiek slepen om in te zoomen.
• Scope: alleen op het tabblad Outbound kun je de pagina beperken tot één nummer, template, templatecategorie of tag, één tegelijk. Twee delen van de pagina negeren de scope en beslaan altijd de hele werkruimte: de lijst met foutcodes en het paneel Breakdowns.

Berichten tellen mee in de periode waarin Bird ze heeft geaccepteerd, dus een bezorgbevestiging die vandaag binnenkomt, werkt de cijfers van gisteren bij. De meest recente uren kunnen minder bezorgingen tonen dan zodra alle bevestigingen binnen zijn.

Samenvattingstegels

Een tegel buiten zijn gezonde bereik toont Needs attention. Bekijk de faaloorzaken om te zien waarom.

Bezorgingen over tijd

De grafiek toont geaccepteerde, bezorgde en mislukte berichten per uur (bereik van 24 uur) of per dag (langere bereiken). Gebruik hem om een piek te herkennen, bijvoorbeeld na het versturen van een campagne of wanneer een template wordt afgewezen.

Faaloorzaken

De faalpercentagegrafiek volgt het faalpercentage over het hele bereik. Daaronder zijn fouten gegroepeerd op foutcode, met de meest voorkomende bovenaan. De lijst toont maximaal 50 codes die in het bereik voorkwamen, dus in een lange lijst kan een zeldzame code ontbreken. De foutcodes gelden altijd voor de hele werkruimte, ook als je de pagina beperkt tot een scope. De laatste rij, Rejected, telt berichten die Bird heeft geweigerd voordat ze werden geaccepteerd. Die tellen niet mee in het faalpercentage, dus de rij toont een aantal zonder aandeel.

Latentie

De latentietabel toont p50-, p95- en p99-tijden voor drie fasen:

• Verwerking: vanaf het moment dat Bird het bericht accepteert tot de overdracht aan WhatsApp.
• Bezorging: vanaf de overdracht aan WhatsApp totdat WhatsApp de bezorging op het toestel van de ontvanger bevestigt.
• Totaal: beide fasen samen.

Een trage Bezorging-fase betekent meestal dat telefoons van ontvangers offline waren, iets waar Bird geen controle over heeft. Een trage Verwerking-fase is het onderzoeken waard. Als de p50 er goed uitziet maar de p99 traag is, is vaak één template of bestemming de oorzaak.

Uitsplitsingen

Het Breakdowns-paneel splitst geaccepteerde, bezorgde en mislukte berichten uit op nummer, template, templatecategorie, tag of land. Elke rij is gemarkeerd als Healthy of Needs attention op basis van dezelfde drempels als de samenvattingstegels. Elk tabblad toont de top 50 rijen voor het bereik.

Tags zijn de tags die je instelt bij het verzenden. Een bericht met meerdere tags verschijnt in de rij van elk van die tags. Ontvangers van wie het land niet kan worden bepaald, verschijnen onder ZZ, en groepsverzendingen worden weggelaten uit het landtabblad.

Programmatische toegang

Dezelfde cijfers zijn beschikbaar via de API, de SDK's (bird.whatsapp.stats), de CLI (bird whatsapp stats) en de MCP-server. Begin met deze endpoints:

• Statistieken: samenvatting, dagelijks en per uur
• Uitsplitsingen op nummer, template, templatecategorie, tag, land en foutcode
• Inkomende statistieken: samenvatting, dagelijks, per uur en per nummer

Elke referentiepagina vermeldt de geaccepteerde tijdbereiken, filters en antwoordvelden.

Volgende stappen

• WhatsApp-log: een enkel bericht opzoeken
• Berichtstatusevents: de events waarop deze statistieken zijn gebaseerd
• Berichtstatuswebhooks: ontvang elke statuswijziging zodra die plaatsvindt