Der history-Webhook
history überträgt einmalig die vorhandenen Gespräche einer Coexistence-Nummer an die API. Das Feld wird nach dem Onboarding gesendet, wenn die Freigabe des Verlaufs akzeptiert wurde. Es ist das einzige Signal, das eine Integration überhaupt über den erfolgten Transfer erhält.
Das Zeitfenster nach dem Onboarding, in dem die Synchronisierung gestartet werden muss.
Der Fehler, der zurückgegeben wird, wenn die Synchronisierung bereits verwendet wurde.
Der Fehler, der bei einem Versuch außerhalb dieses Zeitfensters zurückgegeben wird.
Was wird übertragen
Der vollständige 1:1-Nachrichtenverlauf, den eine Nummer bereits in der WhatsApp Business App hatte, wird übertragen. So startet die Software nicht ohne Kontext bei einer Nummer, die ein Unternehmen seit Jahren nutzt.
Nicht übertragen werden Gruppengespräche. Sie sind bei einer Coexistence-Nummer vollständig von der API ausgeschlossen. Auch die Funktionen der App selbst werden nicht übertragen: Labels, Schnellantworten sowie Begrüßungs- und Abwesenheitsnachrichten haben kein API-Gegenstück und bleiben auf dem Gerät.
Dieses Feld existiert nur für Coexistence-Nummern. Bei einer auf gewöhnliche Weise verbundenen Nummer gibt es keinen vorherigen App-Verlauf zu übertragen, daher gibt es für sie nichts zu liefern.
Warum wird es nur einmal gesendet
Weil der Transfer Teil des Onboardings und keine fortlaufende Funktion ist.
Der Inhaber des Unternehmens wird während Embedded Signup gefragt, ob vorhandene Gespräche geteilt werden sollen. Erst die Zustimmung ermöglicht die Synchronisierung. Es gibt keine Einstellung, die sie danach wieder aktiviert, und keinen Endpoint, der sie erneut ausführt. Ein zweiter Versuch gibt 2593107 zurück, nicht ein Rate-Limit, das sich später aufhebt.
Außerdem gibt es eine Frist. Die Synchronisierung muss innerhalb von 24 Stunden nach dem Onboarding gestartet werden. Ein späterer Versuch gibt 2593108 zurück. Fehlt eine der Voraussetzungen, muss die Nummer getrennt und der gesamte Ablauf erneut durchgeführt werden.
Was sollte ein Handler damit tun
Behandeln Sie das Feld als einmalig eintreffenden, möglicherweise großen Batch und nicht als weiteren Datenverkehr auf dem Nachrichtenpfad.
- Bestätigen Sie den Eingang schnell und verarbeiten Sie ihn asynchron, wie jede andere Zustellung.
- Vermeiden Sie Duplikate anhand der Nachrichten-ID: history und Live-Nachrichten können sich rund um das Onboarding überschneiden.
- Rechnen Sie damit, dass das Feld fehlt. Wenn der Inhaber den Verlauf ablehnt, wird hier nichts gesendet. Die Integration muss in beiden Fällen funktionieren.
- Blockieren Sie das Onboarding nicht. Die Verbindung ist bereits nutzbar, bevor der Transfer abgeschlossen ist.
Häufige Fehler
- Eine Integration bauen, die das Vorhandensein von history voraussetzt. Viele Nummern werden ohne diesen Verlauf verbunden.
- Die Synchronisierung nach 2593107 erneut versuchen. Es handelt sich um ein einmaliges Ereignis, daher gibt der erneute Versuch denselben Fehler zurück.
- Die Entscheidung über den Verlauf erst beim Start der Integrationsarbeit treffen, was meist nach Ablauf des 24-Stunden-Fensters geschieht.
EasyCoexistence protokolliert das Onboarding und die Verlaufsentscheidung in der Verbindungschronik. Ob und an welchem Tag eine Nummer synchronisiert wurde, ist dadurch ein datierter Fakt und muss später nicht rekonstruiert werden.
Häufig gestellte Fragen
Wie viel Verlauf wird übertragen?
Ein Zeitraum mit aktuellen 1:1-Gesprächen, der von Meta und nicht vom Anbieter festgelegt wird.
Werden Gruppenchats übertragen?
Nein. Gruppen sind bei einer Coexistence-Nummer vollständig von der API ausgeschlossen.
Kann ich den Transfer später erneut anfordern?
Nein. Er läuft pro Onboarding einmal. Eine erneute Ausführung erfordert, die Nummer zu trennen und wieder zu verbinden.
Was passiert, wenn der Inhaber den Verlauf ablehnt?
Über dieses Feld trifft nichts ein. Die API sieht nur Nachrichten ab dem Zeitpunkt, an dem die Nummer verbunden wurde.
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