Der Webhook phone_number_quality_update
phone_number_quality_update meldet Änderungen bei Durchsatz und Nachrichtenlimit einer Nummer. Seit 2026 enthält er trotz seines Namens nicht die grüne, gelbe oder rote Qualitätsbewertung. Diese muss stattdessen direkt an der Nummer abgefragt werden.
Das Jahr, in dem der Inhalt dieses Felds von der Farbbewertung abwich.
Qualitätsbewertungen einer Nummer: grün, gelb und rot. Keine davon kommt hier an.
Der Fehler, den eine Nummer zurückgibt, sobald die Qualitätsbegrenzung greift.
Was enthält dieser Webhook tatsächlich?
Informationen zu Durchsatz und Nachrichtenlimit, übermittelt als Ereigniswert mit Feldern für das aktuelle Limit.
Praktisch bedeutet das: Die Kapazität einer Nummer hat sich geändert. Sie wechselte in eine andere Nachrichtenstufe oder ihr Durchsatz wurde angepasst. Diese Änderungen sollten Sie speichern, weil sie den möglichen Umfang einer Integration verändern und eine sinkende Stufe ein frühes Warnsignal ist.
Nicht enthalten ist trotz des Feldnamens die Qualitätsbewertung. Ein Handler nach älterer Dokumentation sucht hier nach GREEN, YELLOW oder RED, findet nichts und schließt daraus, dass sich die Qualität nie ändert.
Woher kommt die Farbbewertung dann?
Durch direktes, planmäßiges Auslesen der Nummer.
Das Feld quality_rating liegt am Nummernobjekt in der Graph API und muss abgefragt werden, statt auf ein Ereignis zu warten. Deshalb braucht eine korrekte Überwachung einer Verbindung sowohl einen Poller als auch einen Webhook-Empfänger: Beide übertragen unterschiedliche Informationen, und keiner reicht allein aus.
Darum bleibt ein Qualitätsabfall für die meisten Integrationen unsichtbar. Nichts überträgt ihn, die WhatsApp Business App zeigt keinen Hinweis, und sobald der Fehler 131048 auftritt, sind die betroffenen Sendungen bereits fehlgeschlagen.
Häufige Fehler
- In dieser Payload nach GREEN, YELLOW oder RED suchen. Seit 2026 sind sie dort nicht enthalten.
- Die Überwachung nur auf Webhooks aufbauen. Die Qualitätsbewertung muss abgefragt werden.
- Eine sinkende Stufe ignorieren. Sie ist meist das erste sichtbare Anzeichen eines Problems.
EasyCoexistence fragt Qualitätsbewertung, Nachrichtenstufe und Durchsatz jeder verbundenen Nummer regelmäßig ab und speichert jede Prüfung, sodass ein Rückgang sichtbar wird, bevor eine Sendung scheitert.
Häufig gestellte Fragen
Warum ist das Feld dann nach der Qualität benannt?
Der Name stammt aus der Zeit vor der Änderung. Er blieb bestehen, während sich der Inhalt änderte, und sorgt deshalb für Verwirrung.
Wie oft sollte die Bewertung abgefragt werden?
Oft genug, um einen Rückgang zu erkennen, bevor er zu einer Begrenzung führt. Wir fragen sie regelmäßig ab, statt nur bei Bedarf.
Zeigt die App die Bewertung an?
Nein. In der WhatsApp Business App auf dem Telefon ist sie nirgends sichtbar.
Hat 131048 damit zu tun?
Ja. Diesen Fehler gibt eine Nummer zurück, sobald eine niedrige Bewertung zu einer Begrenzung führt.
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