WhatsApp-Webhook-Felder und ihre Zuordnung

Welche Inhalte trägt jedes Feld?

messages enthält alles, was ein Kunde an die Nummer sendet: Text, Medienreferenzen, Antworten und Reaktionen. smb_message_echoes enthält, was Ihr Team aus der WhatsApp Business App sendet. Dieses Feld gibt es nur bei einer Coexistence-Nummer und es ermöglicht Software, die Antworten von Menschen zu erkennen.

account_update enthält den Verbindungsstatus: PARTNER_REMOVED, wenn die App vom Konto deinstalliert wurde, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED sowie Ereignisse zu Einschränkungen oder Verstößen. phone_number_quality_update enthält Änderungen an Qualitätsbewertung und Durchsatz. account_alerts enthält Warnungen, die Meta für das Konto auslöst, und account_review_update enthält das Ergebnis einer Prüfung.

business_capability_update enthält Änderungen an Nachrichtenlimits und Funktionen. phone_number_name_update enthält Genehmigungen und Ablehnungen des Anzeigenamens.

Warum ist die Aufteilung architektonisch wichtig?

Weil sie bestimmt, ob Gesprächsinhalte jemals einen Anbieter erreichen.

Die Einstellung leitet die beiden Nachrichtenfelder direkt von Meta an Ihren Endpoint weiter. Die sechs Betriebsfelder werden weiterhin an den Anbieter gesendet. Dadurch sind Dashboard und Alarmierung möglich, ohne dass jemand eine Nachricht verwalten muss.

Darum kann die Aussage, dass Nachrichten nicht gespeichert werden, strukturell statt nur richtlinienbasiert sein. Wenn die Nachrichtenfelder an einen anderen Ort geliefert werden, gibt es keinen Codepfad, auf dem sie gespeichert werden könnten. Bei uns fällt ein Konto ohne diese Einstellung auf den Standard-Callback zurück. Der Handler verwirft diese Ereignisse, ohne sie zu speichern.

Welche Felder sollte Ihr Handler erwarten?

Nur die beiden Nachrichtenfelder, wenn die Einstellung gesetzt ist. Es empfiehlt sich, den Handler so zu schreiben, dass er alles andere ignoriert, statt daran zu scheitern.

Meta fügt mit der Zeit Felder hinzu, und eine Payload kann unbemerkt neue Schlüssel erhalten. Ein Handler, der anhand des Feldnamens verzweigt und unbekannte Felder ignoriert, bleibt funktionsfähig. Einer, der eine feste Struktur voraussetzt, bricht beim ersten unbekannten Ereignis ab.

Behandeln Sie auch smb_message_echoes ausdrücklich, statt es als unwichtig zu behandeln. Ohne dieses Feld weiß die Software nicht, dass ein Mensch bereits geantwortet hat. So erhält ein Kunde sonst zwei Antworten auf dieselbe Frage.

Häufige Fehler

• Eine generische Payload voraussetzen. Jedes Ereignis nennt sein Feld, und der Handler sollte danach verzweigen.
• smb_message_echoes ignorieren. Ohne dieses Feld antwortet die Software zusätzlich zu einem Menschen, der bereits geantwortet hat.
• Bei unbekannten Feldern fehlschlagen, statt sie zu überspringen. Meta fügt Felder ohne Rückfrage hinzu.

Häufig gestellte Fragen

Weiterlesen