Der account_update-Webhook und jeder Trennungsgrund
Mit account_update meldet Meta, dass eine Verbindung ihren Zustand geändert hat. Sein event-Feld nennt das Geschehen. Bei einer Entfernung nennt disconnection_info.reason den Grund. Dieser Grund entscheidet, ob eine Nummer zurückkommt oder endgültig verloren ist.
Das Ereignis, das Meta sendet, wenn die App von einem Konto deinstalliert wird.
Benannte Trennungsgründe, die eine Entfernung enthalten kann.
Das Inaktivitätsfenster des primären Geräts, das als PRIMARY_INACTIVITY eintrifft.
Welche Ereignisse enthält account_update?
PARTNER_REMOVED, wenn die App vom WhatsApp Business Account deinstalliert wird. Dies ist das maßgebliche Trennungssignal und die Grundlage, auf der Sie aufbauen sollten, statt eine Trennung aus einem Feld abzuleiten, das auf false wechselt.
ACCOUNT_OFFBOARDED, wenn die Nummer vollständig aus dem Onboarding entfernt wird. ACCOUNT_RECONNECTED, wenn eine zuvor entfernte Verbindung zurückkehrt. Dazu kommen die Durchsetzungsereignisse ACCOUNT_RESTRICTION und ACCOUNT_VIOLATION sowie Ereignisse, deren Namen DISABLED oder BAN enthalten.
Auch Verifizierungs- und Genehmigungsergebnisse treffen hier ein, mit Ereignisnamen, die VERIFIED oder APPROVED enthalten. Ein Handler sollte anhand des Ereignisnamens verzweigen und Unbekanntes als Information behandeln, statt daran zu scheitern, da Meta ohne Ankündigung neue Ereignisse hinzufügt.
Was sind die Trennungsgründe?
Sechs, und sie bedeuten sehr unterschiedliche Dinge.
PRIMARY_INACTIVITY ist die Regel von ungefähr vierzehn Tagen: Die WhatsApp Business App wurde auf dem primären Gerät nicht geöffnet. Wiederherstellbar und mit Abstand am häufigsten.
COMPANION_INACTIVITY beschreibt dasselbe bei einem Begleitgerät, allerdings mit einem längeren Zeitraum von etwa dreißig Tagen.
BUSINESS_DOWNGRADE bedeutet, dass die Nummer zur privaten WhatsApp App zurückgewechselt ist. Damit endet Coexistence, weil Coexistence die Business App voraussetzt.
CHANGE_NUMBER bedeutet, dass sich die Telefonnummer selbst geändert hat. USER_RE_REGISTERED bedeutet, dass sie auf einem neuen Gerät erneut registriert wurde. ACCOUNT_DISCONNECTED bedeutet, dass der Kunde die Verbindung absichtlich getrennt hat oder dies durch eine Durchsetzung geschehen ist.
Der Grund trifft außerdem zusammen mit disconnection_info.initiated_by ein. Dieses Feld zeigt, ob eine Person oder das System die Trennung ausgelöst hat.
Warum ist der Grund wichtiger als das Ereignis?
Weil PARTNER_REMOVED allein nicht sagt, was Sie tun sollten.
Eine wegen PRIMARY_INACTIVITY entfernte Nummer kommt zurück: Das Unternehmen öffnet die App, verbindet sie erneut, und alles läuft weiter. Wenn Sie dies als gekündigten Kunden behandeln, senden Sie eine Kündigungs-E-Mail an jemanden, der weiterhin Kunde ist.
Eine wegen BUSINESS_DOWNGRADE oder ACCOUNT_DISCONNECTED entfernte Nummer ist eine andere Situation. Wenn Sie sie als vorübergehend behandeln, bleibt eine Verbindung dauerhaft in der Schwebe.
Wenn eine Entfernung ganz ohne Grund eintrifft, dient initiated_by als Ersatzsignal: Eine von einer Person vorgenommene Entfernung wirkt absichtlich, eine unerklärte durch das System nicht. Diese Unterscheidung sollte im Code getroffen werden und nicht erst später in einem Supportgespräch.
Häufige Fehler
- Jedes PARTNER_REMOVED gleich behandeln. Der Grund unterscheidet zwei Wochen Ruhe von einem Kunden, der gegangen ist.
- Die Trennung aus einem Feld ableiten, das auf false wechselt, statt aus diesem Ereignis. Das erzeugt Fehlalarme.
- Bei einem unbekannten Ereignisnamen scheitern. Meta fügt Ereignisse hinzu, und ein Handler sollte Unbekanntes überspringen.
EasyCoexistence behandelt jeden dieser Fälle anhand seines Namens, speichert den Grund in der Verbindungschronik und trennt eine wiederherstellbare Inaktivitätsentfernung von einer tatsächlich verlorenen Nummer.
Häufig gestellte Fragen
Ist PARTNER_REMOVED dauerhaft?
Normalerweise nicht. Die meisten Fälle enthalten PRIMARY_INACTIVITY. Das bedeutet, dass die App nicht geöffnet wurde und eine erneute Verbindung alles wiederherstellt.
Stellt eine erneute Verbindung mein Webhook-Ziel wieder her?
Nein, und genau hier liegt die Falle. Das Ziel ist eine Überschreibung im App-Abonnement und wird zusammen mit der App deinstalliert. Sie müssen es erneut anwenden.
Was ist COMPANION_INACTIVITY?
Dasselbe Inaktivitätsprinzip bei einem Begleitgerät statt beim primären Gerät, mit einem längeren Zeitraum von ungefähr dreißig Tagen.
Kann ich dieses Ereignis ohne Grund erhalten?
Ja. Dann ist disconnection_info.initiated_by das einzige Signal dafür, ob die Trennung absichtlich erfolgte.
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