WhatsApp-Webhook-Preisobjekt: type, category und billable (2026)
Das Preisobjekt wird in Status-Webhooks mitgeliefert und zeigt, wie Meta eine Nachricht eingestuft hat: billable (wird abgeschafft), pricing_model PMP, type (regular, free_customer_service, free_entry_point oder free_group_customer_service), category wie marketing, utility, authentication oder service sowie optional einen subtype von paid_exempt. Seit dem 1. Oktober 2026 markiert regular jede berechnete Nachricht, einschließlich Service-Nachrichten.
easyCoexistence verbindet Ihre Rufnummer der WhatsApp-Business-App über Coexistence mit Metas Cloud API und leitet die Status-Webhooks, die dieses Objekt enthalten, an Ihren Server weiter, damit Ihr eigenes System die Nutzung zusammenzählen kann.
Das pricing_model in aktuellen Webhooks lautet PMP, also Abrechnung pro Nachricht; CBP erscheint nur in Webhooks, die vor dem 1. Juli 2025 gesendet wurden.
Zugestellte Service-Nachrichten pro Geschäftsrufnummer und Monat innerhalb des kostenlosen Kontingents von Meta, ab dem 1. Oktober 2026.
Der type einer berechneten Nachricht, einschließlich Service-Nachrichten, die nach Verbrauch des kostenlosen Kontingents der Nummer zugestellt werden.
Der subtype bei Service-Nachrichten, die kostenlos sind, weil die Organisation eine berechtigte Behörde oder gemeinnützige Einrichtung ist.
Staffelungsdetails in Webhooks; Meta verweist für Informationen zu Volumenstaffeln auf das Feld pricing_analytics.
Wo erscheint das Preisobjekt?
Nur bei Status-Webhooks, und auch dort nicht bei allen: Meta liefert es mit dem Status sent und mit einem der Status delivered oder read. Ein Beispiel der Referenz zu v24.0 zeigt, dass es bei sent fehlt, weil es stattdessen im delivered-Webhook kam. Fehlgeschlagene Status enthalten es nie. Behandeln Sie den Preis deshalb als Eigenschaft der Nachricht, identifiziert über ihre wamid, und speichern Sie ihn einmal, egal welcher Status ihn bringt. Metas eigene Beispiele des Objekts für eine Service-Nachricht, vor und nach Ablauf des monatlichen kostenlosen Kontingents der Nummer:
// Service message delivered while the number is within its free tier
"pricing": {
"billable": false,
"pricing_model": "PMP",
"type": "free_customer_service",
"category": "service"
}
// Service message delivered after the number's free tier has been used
"pricing": {
"billable": true,
"pricing_model": "PMP",
"type": "regular",
"category": "service"
}Was bedeuten die type-Werte seit dem 1. Oktober 2026?
type ist das Feld, das angibt, ob Meta berechnet. Seine Bedeutung hat sich am 1. Oktober 2026 verschoben, als Meta begann, Service-Nachrichten und Utility-Templates als Antwort auf eine Kundenanfrage pro Nachricht zu berechnen. Code, der vor diesem Datum geschrieben wurde, liest free_customer_service möglicherweise als Antwort im offenen Zeitfenster; heute bedeutet es eine Service-Nachricht im Einzelgespräch innerhalb des monatlichen kostenlosen Kontingents der Nummer. billable erscheint weiterhin, Meta kündigt aber an, es abzuschaffen, und bittet, type und category gemeinsam zu lesen.
| Through 30 Sep 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
Welche Kategorien kann eine Nachricht haben?
category benennt den Tarif, den Meta bei einer Berechnung anwendet. Es ist das Feld, nach dem Sie beim Abgleich mit Metas Rechnung gruppieren, zusammen mit dem Land der Rufnummer des Kunden, da die Tarife je Markt variieren. Eine Nachricht hat genau eine Kategorie und genau eine Berechnung: Eine Nicht-Template-Nachricht mit Werbeinhalt bleibt eine Service-Nachricht und wird nicht zusätzlich als Marketing berechnet. Die Werte, die Meta auflistet:
Wie zählen Sie Entgelte aus Webhooks?
Webhooks zeigen, welche Nachrichten abrechenbar sind und in welcher Kategorie, nicht was sie kosten. Um eine Nutzungsübersicht zu erstellen, die zu Metas Abrechnung passt, zählen Sie nach Nachricht und nach Kategorie und wenden dann die veröffentlichten Tarife von Meta für jeden Markt an oder lesen das Feld pricing_analytics aus, das Aufschlüsselungen pro Nachricht und Staffelungen liefert.
- Deduplizieren Sie nach wamid, da das Preisobjekt auf mehr als einem Status erscheinen kann und Wiederholungen Webhooks doppelt senden.
- Zählen Sie eine Nachricht als berechnet, wenn type regular ist; gruppieren Sie nach category und dem Land des Empfängers.
- Ignorieren Sie fehlgeschlagene Nachrichten: Meta berechnet nur zugestellte Nachrichten.
- Ab v24.0 erwarten Sie kein conversation-Objekt außer innerhalb eines Zeitfensters mit kostenlosem Einstiegspunkt, und dort ist seine id je Fenster eindeutig.
Was bedeutet das für KI-Antworten auf einer Coexistence-Nummer?
Jede Antwort, die Ihre KI oder eine Automatisierung über die API sendet, ist eine Nicht-Template-Nachricht, daher ist ihre Kategorie service: Innerhalb des monatlichen kostenlosen Kontingents der Nummer zeigt sie free_customer_service, danach regular. Templates, die Ihre KI mit send_template sendet, tragen ihre eigene Kategorie. Metas Coexistence-Leitfaden nennt einen Unterschied, der für die Kosten wichtig ist: Nachrichten, die der Inhaber in der WhatsApp-Business-App tippt, unterliegen nicht dem Kundenservice-Fenster und beeinflussen die Preise der Cloud API nicht.
Meta rechnet Nachrichten dem eigenen WhatsApp-Business-Konto des Unternehmens pro Nachricht ab, nach Kategorie und Land; easyCoexistence schlägt nie einen Aufpreis darauf auf, und KI-Nutzung wird von Ihrem KI-Anbieter über Ihren eigenen Schlüssel abgerechnet.
Häufige Fehler
- Das Preisobjekt bei jedem Auftreten zu zählen. Es kann auf mehr als einem Status derselben Nachricht erscheinen; zählen Sie einmal pro wamid.
- billable allein zu lesen. Meta schafft es ab und bittet, type und category gemeinsam zu verwenden.
- Die Lesart von free_customer_service aus der Zeit vor Oktober beizubehalten. Seit dem 1. Oktober 2026 markiert es eine Service-Nachricht innerhalb des monatlichen kostenlosen Kontingents der Nummer.
- Beträge im Payload zu erwarten. Das Objekt benennt die Kategorie; die Tarife stammen aus Metas Preislisten oder aus pricing_analytics.
Metas Entgelte bleiben auf Ihrem eigenen WhatsApp-Business-Konto und werden nie aufgeschlagen. US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Welches Konto zahlt für eine Nachricht?
Das WhatsApp-Business-Konto, das sie gesendet hat. Wenn mehrere Konten über dieselbe Nummer senden, rechnet Meta jede Berechnung dem Konto zu, das die Nachricht gesendet hat, mit eigener Zahlungsmethode und eigenen Ausgabelimits.
Was ist marketing_lite?
Die Kategorie und der Typ der Preisgestaltung für Nachrichten, die über Metas Marketing Messages API für WhatsApp gesendet werden, ein separater Versandweg für Marketing-Templates mit eigenen Preisoptionen, etwa einem Höchstpreis pro Zustellung.
Wann hat die Preisgestaltung pro Nachricht Konversationen ersetzt?
Am 1. Juli 2025. Webhooks, die vor diesem Datum gesendet wurden, können pricing_model CBP zeigen, also konversationsbasierte Preisgestaltung; spätere zeigen PMP. Code, der Entgelte noch nach conversation-id gruppiert, muss aktualisiert werden.
Wird das kostenlose Kontingent jeden Monat zurückgesetzt?
Ja. Meta gewährt jeder Geschäftsrufnummer 1,000 zugestellte Service-Nachrichten pro Monat ohne Übertrag, mit Zurücksetzung um Mitternacht in der Zeitzone des WhatsApp-Business-Kontos.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am