Der Webhook smb_app_state_sync
smb_app_state_sync überträgt den Zustand der WhatsApp Business App selbst, vor allem die Kontaktsynchronisierung, die startet, wenn eine Coexistence-Nummer verbunden wird. Das Feld ist von history getrennt, das Unterhaltungen überträgt, und existiert nur für Coexistence-Nummern.
Spezifische Coexistence-Synchronisierungsfelder: dieses Feld und history.
Das Zeitfenster nach dem Onboarding, in dem die Synchronisierung starten muss.
Das entsprechende Verhalten bei einer Nummer, die ohne Coexistence eingebunden wurde.
Was es überträgt
Den App-seitigen Zustand, praktisch also die Kontakte, die ein Unternehmen bereits auf dem Telefon hatte.
Jeder Kontakt mit einer WhatsApp-Nummer kann mit der Plattform synchronisiert werden. So erkennt die Software einen Kunden, der seit Jahren im Telefon des Unternehmens gespeichert ist, statt ihn als neue Nummer zu behandeln. Das ist etwas anderes als die Unterhaltungen selbst, die über das Feld history eintreffen. Beide sind getrennt, weil das eine ein Verzeichnis und das andere ein Gesprächsprotokoll ist.
Wie history existiert auch dieses Feld nur bei Coexistence. Für eine Nummer, die nie in einer solchen App verwendet wurde, gibt es keinen App-Zustand zur Synchronisierung.
Was es nicht überträgt
Die eigenen Arbeitsfunktionen der App, für die es auf Plattformseite keine Entsprechung gibt.
- Labels, die auf dem Gerät liegen und von Software nicht gelesen werden können.
- Schnellantworten sowie Begrüßungs- und Abwesenheitsnachrichten.
- Katalog, Bestellungen und Status.
- Channels sowie der Verlauf von Sprach- und Videoanrufen.
Warum das für eine Integration wichtig ist
Weil dadurch festgelegt wird, ob Ihr System ab dem ersten Tag weiß, wer schreibt.
Ohne Kontaktsynchronisierung kommt jede eingehende Nachricht als Telefonnummer ohne zugehörigen Namen an, und Sie müssen sie einem Kundendatensatz zuordnen. Mit der Synchronisierung ist die eigene Kontaktliste des Unternehmens verfügbar, sodass die Zuordnung größtenteils erledigt ist.
Es lohnt sich, für beide Fälle zu planen, weil ein Unternehmen die Synchronisierung ablehnen oder das Zeitfenster verpassen kann. Eine Integration, die von vorhandenen Kontakten ausgeht, zeigt sonst jedem, der sie öffnet, eine Wand aus unformatierten Nummern.
Häufige Fehler
- Davon ausgehen, dass Kontakte vorhanden sind. Ein Unternehmen kann die Synchronisierung ablehnen oder das Zeitfenster verpassen.
- Labels oder Schnellantworten in dieser Payload erwarten. Sie bleiben auf dem Gerät.
- Das Feld mit history verwechseln, das Unterhaltungen statt der Kontaktliste überträgt.
EasyCoexistence abonniert die operativen Felder und zeichnet die Onboarding-Sequenz auf. So ist in der Timeline sichtbar, was eine Nummer synchronisiert hat oder nicht.
Häufig gestellte Fragen
Ist das dasselbe wie die history-Synchronisierung?
Nein. Dieses Feld überträgt den App-Zustand, vor allem Kontakte. history überträgt die Unterhaltungen.
Läuft das mehr als einmal?
Die erste Synchronisierung ist ein einmaliger Teil des Onboardings und hat dasselbe Zeitfenster von 24 Stunden wie history.
Bekomme ich Labels?
Nein. Labels sind eine App-Funktion ohne API-Entsprechung.
Existiert das bei einer normalen Cloud API-Nummer?
Nein. Für eine solche Nummer gibt es keinen WhatsApp Business App-Zustand zur Synchronisierung.
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