Skip to main content
Con OAuth, los usuarios inician sesión en Whop por sí mismos mediante una página de inicio de sesión o un webview de iOS. Tu app recibe tokens de usuario de Whop que pueden autenticar el chat incrustado y actuar en nombre del usuario que ha iniciado sesión. Usa OAuth cuando tu app necesite acceder a la cuenta de Whop del usuario o cuando no quieras generar tokens de usuario con alcance de cuenta desde tu propio backend.

Guía completa de OAuth

Consulta la guía general de OAuth para ver el flujo completo de OAuth 2.1 + PKCE y los detalles del intercambio, la renovación y la revocación de tokens.

Configuración

El objeto App que devuelve apps.create en el @whop/sdk actual no expone un campo client_secret. Copia el secreto del cliente desde la pestaña Panel.
Usa el endpoint Create App para crear una app de OAuth mediante programación:
Actualiza las URI de redirección más adelante con el endpoint Update App.

Alcances necesarios

Tu configuración de OAuth debe incluir estos alcances:

Endpoint de token web

Tu servidor debe proporcionar un endpoint de token que devuelva un token de OAuth válido con los alcances necesarios. Los elementos de chat de React y JavaScript sin framework llaman a esta función siempre que necesitan autenticarse.
Consulta la guía de OAuth para implementar el intercambio de tokens en el servidor.

OAuth gestionado por el kit de desarrollo de software en iOS

Llama a configureWithOAuth al iniciar la app. El SDK gestiona todo el flujo: muestra un webview de inicio de sesión, obtiene los tokens y los renueva automáticamente.
De forma predeterminada, el SDK usa tu identificador de bundle para la URI de redirección (com.yourapp.bundle://oauth/callback). Puedes personalizarla:
Asegúrate de que la URI de redirección coincida con la que configuraste en el panel de Whop > Developer > App > OAuth. Cuando un usuario navega a una vista de chat, el SDK inicia automáticamente el flujo de OAuth si todavía no está autenticado. También puedes iniciar y cerrar sesión manualmente:

Seguimiento del estado de autenticación

Usa el modificador .whopAuthState para saber de forma reactiva si el usuario ha iniciado sesión:

Rellenar tokens previamente

Si ya tienes los tokens de Whop del usuario desde otra fuente, puedes rellenarlos previamente para omitir el webview de inicio de sesión en el primer arranque. Las fuentes incluyen un flujo de OAuth web o tokens sincronizados desde tu backend. Esto es opcional y solo es relevante si tus usuarios ya se han autenticado con Whop en otro lugar.
El SDK extrae la caducidad del token del JSON Web Token (JWT) y gestiona la renovación automáticamente. Si el SDK no puede renovar los tokens previamente rellenados que han caducado, se inicia el flujo normal de OAuth.

Próximos pasos

Autenticación

Compara OAuth con los tokens con alcance de cuenta para el chat incrustado.

Guía general de OAuth

Implementa el flujo completo de OAuth y el intercambio, la renovación y la revocación de tokens.

Chat element

Conoce las props, los eventos, los estilos y las opciones de enlaces directos de la interfaz de chat.

Inicio rápido del chat incrustado

Muestra tu primera experiencia de chat incrustado.