"This authorization code has expired" dopo la registrazione Coexistence
Quando Embedded Signup di Meta termina, consegna alla piattaforma che l'ha avviato un codice di breve durata, da scambiare con un access token entro 30 secondi. Se lo scambio avviene dopo, oppure usa il codice di un tentativo precedente, Meta risponde che il codice di autorizzazione è scaduto. Rieseguire il flusso genera un codice nuovo.
La durata che Meta assegna al codice token scambiabile restituito da Embedded Signup.
Meta indica che lo scambio del token deve essere una richiesta da server a server, mai lato client.
Il tempo di cui dispone una piattaforma dopo l'onboarding per sincronizzare lo storico di un numero Coexistence prima di dover rifare il flusso.
Quale codice è scaduto?
Quando l'azienda completa Embedded Signup, Meta restituisce gli ID degli asset e un codice token scambiabile alla finestra del browser che ha aperto il popup. La piattaforma invia poi quel codice al proprio server, che chiama l'endpoint oauth access_token di Meta con l'ID e il secret della propria app per scambiarlo con un token aziendale.
La guida all'implementazione di Meta è esplicita sui tempi: il codice token scambiabile ha una durata di 30 secondi, quindi la piattaforma deve riuscire a scambiarlo prima che scada. Uno scambio tentato dopo quel momento viene rifiutato, e "This authorization code has expired" è il modo in cui si legge quel rifiuto. L'azienda non ha sbagliato nulla completando il popup lentamente: il conteggio parte da quando il codice viene restituito.
Perché succede se il popup termina in ritardo o viene aperto due volte?
Diverse situazioni possono far slittare lo scambio oltre quel limite.
La scheda del browser è rimasta in background o il portatile è andato in stop mentre il flusso terminava, quindi il codice è arrivato al server della piattaforma molto dopo la sua emissione. Il server della piattaforma ha messo in coda lo scambio dietro altre operazioni invece di eseguirlo subito. Oppure la persona ha aperto il flusso due volte, li ha completati entrambi, e la piattaforma ha scambiato il codice della prima finestra dopo che la seconda era terminata.
Nei test c'è un quarto caso: copiare il codice dalla console del browser e scambiarlo a mano con cURL o Postman. La guida di Meta avverte proprio di questo e consiglia di avere pronta la richiesta di scambio prima di iniziare.
Come si completa la connessione?
Rieseguì il flusso dall'inizio in una sola finestra e lascialo terminare con la pagina della piattaforma in primo piano. Ogni completamento restituisce un codice nuovo, e allo scambio immediato di quel codice la piattaforma non deve aggiungere altro.
Per un numero Coexistence, fallo senza indugi. Meta converte l'account WhatsApp Business quando l'azienda completa il flusso, e una volta che la piattaforma ha fatto l'onboarding del cliente ha 24 ore per sincronizzare lo storico dei messaggi; trascorso questo tempo, l'azienda deve essere disconnessa e completare di nuovo il flusso.
Lato piattaforma, la soluzione duratura è scambiare il codice sul server nel momento in cui arriva, prima di qualsiasi altro passaggio di onboarding.
Errori comuni
- Ritentare lo scambio del token con lo stesso codice. È scaduto dopo 30 secondi e non tornerà valido.
- Eseguire la registrazione in due finestre contemporaneamente. Conta solo il codice del tentativo che si sta scambiando.
- Scambiare il codice dal browser. Meta richiede lo scambio come richiesta da server a server con il secret dell'app.
EasyCoexistence scambia il codice sul proprio server non appena Embedded Signup lo restituisce e registra ogni tentativo nella cronologia della connessione, così un codice perso appare come un evento datato e non come un errore vago.
Domande frequenti
L'azienda ha collegato il numero oppure no?
L'azienda ha completato il flusso di Meta, ma la piattaforma non è riuscita a trasformare il codice in un token funzionante, quindi non può ancora operare sul numero. Rieseguire il flusso le fornisce un codice nuovo.
Si può far durare il codice più a lungo?
No. La durata di 30 secondi la stabilisce Meta e nessuna piattaforma può estenderla.
L'app WhatsApp Business è coinvolta?
No. L'app continua a funzionare sul telefono mentre il problema viene risolto.
È lo stesso di un access token scaduto?
No. Qui si tratta del codice di registrazione di breve durata. Un access token scaduto su una connessione funzionante restituisce l'errore 190.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il