« Ce code d'autorisation a expiré » après l'inscription Coexistence
Quand l'Embedded Signup de Meta se termine, il remet à la plateforme qui l'a lancé un code éphémère, à échanger contre un token d'accès en moins de 30 secondes. Si l'échange a lieu plus tard, ou avec le code d'une tentative précédente, Meta répond que le code d'autorisation a expiré. Relancer le parcours produit un nouveau code.
La durée de vie que Meta accorde au code de token échangeable renvoyé par l'Embedded Signup.
Meta précise que l'échange du token doit être une requête de serveur à serveur, jamais côté client.
Délai dont dispose une plateforme après l'onboarding pour synchroniser l'historique d'un numéro Coexistence avant de devoir refaire le parcours.
Quel code a expiré ?
Quand l'entreprise termine l'Embedded Signup, Meta renvoie les identifiants des ressources et un code de token échangeable à la fenêtre du navigateur qui a ouvert la popup. La plateforme transmet ensuite ce code à son propre serveur, qui appelle l'endpoint oauth access_token de Meta avec son ID d'application et son secret d'application pour l'échanger contre un token d'accès.
Le guide d'implémentation de Meta est explicite sur le délai : le code de token échangeable a une durée de vie de 30 secondes, la plateforme doit donc pouvoir l'échanger avant son expiration. Un échange tenté après ce délai est refusé, et « Ce code d'autorisation a expiré » est la façon dont ce refus s'affiche. L'entreprise n'a rien fait de mal en terminant la popup lentement : le compte à rebours démarre dès que le code est renvoyé.
Pourquoi cela arrive-t-il quand la popup se termine tard ou deux fois ?
Plusieurs situations peuvent repousser l'échange au-delà de cette limite.
L'onglet du navigateur est resté en arrière-plan ou l'ordinateur portable s'est mis en veille au moment où le parcours se terminait, et le code est arrivé sur le serveur de la plateforme bien après son émission. Le serveur de la plateforme a mis l'échange en file d'attente derrière d'autres tâches au lieu de le traiter immédiatement. Ou bien la personne a ouvert le parcours deux fois, a terminé les deux, et la plateforme a échangé le code de la première fenêtre après la fin de la seconde.
En phase de test, il existe un quatrième cas : copier le code depuis la console du navigateur et l'échanger à la main avec cURL ou Postman. Le guide de Meta met précisément en garde contre cela et recommande de préparer la requête d'échange avant de commencer.
Comment finaliser la connexion ?
Relancez le parcours depuis le début dans une seule fenêtre, et laissez-le se terminer avec la page de la plateforme au premier plan. Chaque parcours terminé renvoie un nouveau code, et un échange rapide de ce code suffit à la plateforme.
Pour un numéro Coexistence, agissez sans attendre. Meta convertit le compte WhatsApp Business quand l'entreprise termine le parcours, et une fois le client onboardé par la plateforme, celle-ci dispose de 24 heures pour synchroniser l'historique des messages ; passé ce délai, l'entreprise doit être déconnectée du parcours puis le refaire.
Côté plateforme, la correction durable consiste à échanger le code sur le serveur dès son arrivée, avant toute autre étape d'onboarding.
Erreurs courantes
- Retenter l'échange du token avec le même code. Il a expiré après 30 secondes et ne reviendra pas.
- Lancer l'inscription dans deux fenêtres à la fois. Seul compte le code de la tentative en cours d'échange.
- Échanger le code depuis le navigateur. Meta exige un échange sous forme de requête de serveur à serveur avec le secret d'application.
EasyCoexistence échange le code sur son serveur dès que l'Embedded Signup le renvoie, et consigne chaque tentative dans la chronologie de la connexion : un code perdu apparaît comme un événement daté plutôt que comme un échec vague.
Questions fréquemment posées
L'entreprise a-t-elle connecté le numéro ou non ?
L'entreprise a terminé le parcours de Meta, mais la plateforme n'a pas pu transformer le code en token fonctionnel : elle ne peut donc pas encore agir sur le numéro. Relancer le parcours lui fournit un nouveau code.
Peut-on faire durer le code plus longtemps ?
Non. Meta fixe la durée de vie à 30 secondes, et aucune plateforme ne peut la prolonger.
L'application WhatsApp Business est-elle touchée ?
Non. L'application continue de fonctionner sur le téléphone pendant la résolution du problème.
Est-ce la même chose qu'un token d'accès expiré ?
Non. Il s'agit ici du code d'inscription éphémère. Un token d'accès expiré sur une connexion qui fonctionnait renvoie l'erreur 190.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le