„This authorization code has expired“ nach dem Coexistence-Signup
Wenn der Embedded Signup von Meta abgeschlossen ist, übergibt er der startenden Plattform einen kurzlebigen Code. Dieser muss innerhalb von 30 Sekunden gegen ein Access-Token getauscht werden. Erfolgt der Tausch später oder mit dem Code eines früheren Versuchs, antwortet Meta, der Autorisierungscode sei abgelaufen. Wer den Ablauf erneut durchläuft, erhält einen frischen Code.
Die Gültigkeitsdauer, die Meta dem tauschbaren Token-Code aus dem Embedded Signup gibt.
Laut Meta muss der Token-Tausch eine Server-zu-Server-Anfrage sein, niemals eine clientseitige.
Zeit, die einer Plattform nach dem Onboarding bleibt, um den Verlauf einer Coexistence-Nummer zu synchronisieren, bevor der Ablauf wiederholt werden muss.
Welcher Code ist abgelaufen?
Wenn das Unternehmen den Embedded Signup abschließt, gibt Meta die Asset-IDs und einen tauschbaren Token-Code an das Browserfenster zurück, das das Popup geöffnet hat. Die Plattform sendet diesen Code dann an ihren eigenen Server. Der Server ruft den oauth-access_token-Endpoint von Meta mit App-ID und App-Secret auf und tauscht den Code gegen ein Unternehmens-Token.
Die Implementierungsanleitung von Meta ist beim Timing eindeutig: Der tauschbare Token-Code hat eine Gültigkeitsdauer von 30 Sekunden, die Plattform muss ihn also tauschen können, bevor er verfällt. Ein späterer Tauschversuch wird abgelehnt, und „This authorization code has expired“ ist die Meldung zu dieser Ablehnung. Das Unternehmen hat nichts falsch gemacht, wenn es das Popup langsam abgeschlossen hat: Die Uhr läuft ab dem Moment, in dem der Code zurückgegeben wird.
Warum passiert das, wenn das Popup spät oder zweimal abgeschlossen wird?
Mehrere Situationen können den Tausch über dieses Limit hinaus verzögern.
Der Browser-Tab blieb im Hintergrund oder der Laptop ging in den Ruhezustand, als der Ablauf endete, sodass der Code erst lange nach der Ausstellung beim Server der Plattform ankam. Der Server der Plattform hat den Tausch hinter anderer Arbeit eingereiht, statt ihn sofort auszuführen. Oder die Person hat den Ablauf zweimal geöffnet, beide abgeschlossen, und die Plattform hat den Code aus dem ersten Fenster getauscht, nachdem das zweite fertig war.
Beim Testen gibt es einen vierten Fall: Der Code wird aus der Browserkonsole kopiert und von Hand mit cURL oder Postman getauscht. Die Anleitung von Meta warnt genau davor und rät, die Tauschanfrage bereitzuhalten, bevor der Ablauf beginnt.
Wie schließen Sie die Verbindung ab?
Starten Sie den Ablauf von vorn in einem einzigen Fenster und lassen Sie ihn mit der Seite der Plattform im Vordergrund enden. Jeder Abschluss liefert einen neuen Code, und ein zügiger Tausch dieses Codes ist alles, was die Plattform braucht.
Bei einer Coexistence-Nummer sollte das zügig geschehen. Meta wandelt das WhatsApp-Business-Konto um, wenn das Unternehmen den Ablauf abschließt. Sobald die Plattform den Kunden per Onboarding angebunden hat, bleiben ihr 24 Stunden, um den Nachrichtenverlauf zu synchronisieren. Danach muss das Unternehmen abgemeldet werden und den Ablauf erneut durchlaufen.
Auf Seiten der Plattform besteht die dauerhafte Lösung darin, den Code auf dem Server in dem Moment zu tauschen, in dem er eintrifft, noch vor jedem anderen Onboarding-Schritt.
Häufige Fehler
- Den Token-Tausch mit demselben Code wiederholen. Er ist nach 30 Sekunden abgelaufen und kommt nicht zurück.
- Den Signup in zwei Fenstern gleichzeitig durchführen. Nur der Code des Versuchs, der gerade getauscht wird, zählt.
- Den Code im Browser tauschen. Meta verlangt den Tausch als Server-zu-Server-Anfrage mit dem App-Secret.
EasyCoexistence tauscht den Code auf seinem Server, sobald der Embedded Signup ihn zurückgibt, und protokolliert jeden Versuch in der Zeitleiste der Verbindung. Ein verlorener Code erscheint so als datiertes Ereignis statt als vager Fehler.
Häufig gestellte Fragen
Hat das Unternehmen die Nummer nun verbunden oder nicht?
Das Unternehmen hat den Ablauf von Meta abgeschlossen, aber die Plattform konnte den Code nicht in ein funktionierendes Token umwandeln und kann deshalb noch nicht auf die Nummer zugreifen. Ein erneuter Durchlauf liefert einen frischen Code.
Lässt sich die Gültigkeit des Codes verlängern?
Nein. Meta legt die Gültigkeitsdauer von 30 Sekunden fest, und keine Plattform kann sie verlängern.
Ist die WhatsApp Business app betroffen?
Nein. Die App funktioniert auf dem Telefon weiter, während das Problem gelöst wird.
Ist das dasselbe wie ein abgelaufenes Access-Token?
Nein. Hier geht es um den kurzlebigen Signup-Code. Ein abgelaufenes Access-Token bei einer funktionierenden Verbindung liefert den Fehler 190.
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