«Este código de autorización ha caducado» después del registro de Coexistencia
Cuando termina Embedded Signup de Meta, entrega a la plataforma que lo inició un código de corta duración que debe intercambiarse por un token de acceso en un plazo de 30 segundos. Si el intercambio ocurre después o usa un código de un intento anterior, Meta responde que el código de autorización ha caducado. Volver a ejecutar el flujo genera un código nuevo.
El tiempo de vida que Meta asigna al código intercambiable devuelto por Embedded Signup.
Meta indica que el intercambio del token debe ser una petición de servidor a servidor, nunca del lado del cliente.
El tiempo que tiene la plataforma después del registro para sincronizar el historial de un número de Coexistencia antes de repetir el flujo.
¿Qué código ha caducado?
Cuando el negocio completa Embedded Signup, Meta devuelve los ID de los activos y un código de token intercambiable a la ventana del navegador que abrió la ventana emergente. Luego, la plataforma envía ese código a su propio servidor, que llama al endpoint oauth access_token de Meta con el ID y el secreto de su app para intercambiarlo por un token del negocio.
La guía de implementación de Meta es explícita sobre el tiempo: el código de token intercambiable tiene un tiempo de vida de 30 segundos, por lo que la plataforma debe poder intercambiarlo antes de que caduque. Un intercambio intentado después de ese momento se rechaza, y «Este código de autorización ha caducado» es el mensaje de ese rechazo. El negocio no hizo nada mal por completar lentamente la ventana emergente: el reloj empieza cuando se devuelve el código.
¿Por qué ocurre después de que la ventana emergente termina tarde o dos veces?
Varias situaciones pueden retrasar el intercambio más allá de ese límite.
La pestaña del navegador quedó en segundo plano o el portátil entró en suspensión cuando terminó el flujo, de modo que el código llegó al servidor de la plataforma mucho después de emitirse. El servidor de la plataforma puso el intercambio en cola detrás de otras tareas en vez de hacerlo de inmediato. También es posible que la persona abriera el flujo dos veces, completara ambos y la plataforma intercambiara el código de la primera ventana después de completar la segunda.
En las pruebas hay una cuarta situación: copiar el código desde la consola del navegador e intercambiarlo manualmente con cURL o Postman. La guía de Meta advierte exactamente sobre esto e indica que la petición de intercambio debe estar preparada antes de comenzar.
¿Cómo se completa la conexión?
Ejecuta el flujo de nuevo desde el principio en una sola ventana y deja que termine con la página de la plataforma en primer plano. Cada finalización devuelve un código nuevo, y un intercambio inmediato de ese código es todo lo que necesita la plataforma.
Para un número de Coexistencia, hazlo sin demora. Meta convierte la cuenta de WhatsApp Business cuando el negocio completa el flujo y, una vez que la plataforma registra al cliente, tiene 24 horas para sincronizar el historial de mensajes. Después, el negocio debe completar la baja y repetir el flujo.
En la plataforma, la solución duradera es intercambiar el código en el servidor en cuanto llegue, antes de cualquier otro paso del registro.
Errores comunes
- Reintentar el intercambio del token con el mismo código. Caducó después de 30 segundos y no volverá a funcionar.
- Ejecutar el registro en dos ventanas a la vez. Solo cuenta el código del intento que se está intercambiando.
- Intercambiar el código desde el navegador. Meta exige que el intercambio sea una petición de servidor a servidor con el secreto de la app.
EasyCoexistence intercambia el código en su servidor en cuanto Embedded Signup lo devuelve y registra cada intento en la cronología de la conexión, por lo que un código perdido aparece como un evento fechado y no como un fallo impreciso.
Preguntas frecuentes
¿El negocio conectó el número o no?
El negocio completó el flujo de Meta, pero la plataforma no pudo convertir el código en un token válido, por lo que todavía no puede actuar sobre el número. Ejecutar el flujo de nuevo proporciona un código nuevo.
¿Se puede hacer que el código dure más?
No. Meta establece el tiempo de vida de 30 segundos y ninguna plataforma puede ampliarlo.
¿La app de WhatsApp Business se ve afectada?
No. La app sigue funcionando en el teléfono mientras se resuelve el problema.
¿Es lo mismo que un token de acceso caducado?
No. Este es el código de registro de corta duración. Un token de acceso caducado en una conexión activa devuelve el error 190.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el