> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# OAuth del chat

> Autentica a los usuarios del chat incrustado con OAuth de Whop y el inicio de sesión gestionado por el SDK.

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.

> [card] [Guía completa de OAuth](https://docs.whop.com/es/developer/guides/oauth.md)
>
> 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

> [!WARNING]
>
> 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.

> [tab] API
>
> Usa el endpoint [Create App](https://docs.whop.com/es/api-reference/apps/create-app.md) para crear una app de OAuth mediante programación:
>
> ```typescript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const app = await client.apps.create({
>   name: "My App",
>   redirect_uris: [
>     "http://localhost:3000/api/auth/callback/whop",
>     "https://myapp.com/api/auth/callback/whop"
>   ],
> });
>
> console.log(app.id);            // App ID
> console.log(app.client_secret); // Client Secret
> ```
>
> Actualiza las URI de redirección más adelante con el endpoint [Update App](https://docs.whop.com/es/api-reference/apps/update-app.md).

> [tab] Panel
>
> **1. Crea o selecciona tu app**
>
> Registra tu app en el [panel de Whop](https://whop.com/dashboard/) > Developer para obtener un ID de app.
>
> **2. Añade una URL de redirección**
>
> En la app que creaste, abre OAuth y añade una URL de redirección.
>
> * Para apps de React o JavaScript sin framework, usa la URL de callback de tu app, como `https://yourapp.com/oauth/callback`.
> * Para apps de Swift, usa tu bundle ID, como `com.yourapp.bundle://oauth/callback`, o configura una URI de redirección personalizada.
>
> **3. Selecciona los alcances**
>
> En la misma página, copia los alcances necesarios desde **View available scopes**.

## Alcances necesarios

Tu configuración de OAuth debe incluir estos alcances:

| Alcance | Propósito |
| - | - |
| `openid`, `profile`, `email` | Información básica del perfil |
| `chat:message:create`, `chat:read` | Canales |
| `dms:read`, `dms:message:manage`, `dms:channel:manage` | Mensajes directos |
| `support_chat:read`, `support_chat:message:create` | Chats de soporte |

## 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.

```typescript theme={null}
async function getToken() {
  const response = await fetch("/api/token");
  const data = await response.json();
  return data.token;
}
```

Consulta la [guía de OAuth](https://docs.whop.com/es/developer/guides/oauth.md) 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.

```swift theme={null}
.task {
    await WhopSDK.configureWithOAuth(
        appId: "app_XXXXXXXXXXXXXX",
        scopes: [
            "openid", "profile", "email",
            "chat:message:create", "chat:read",
            "dms:read", "dms:message:manage", "dms:channel:manage",
            "support_chat:read", "support_chat:message:create",
        ]
    )
}
```

De forma predeterminada, el SDK usa tu identificador de bundle para la URI de redirección (`com.yourapp.bundle://oauth/callback`). Puedes personalizarla:

```swift theme={null}
await WhopSDK.configureWithOAuth(
    appId: "app_XXXXXXXXXXXXXX",
    redirectUri: "myapp://auth/callback",
    scopes: [
        "openid", "profile", "email",
        "chat:message:create", "chat:read",
        "dms:read", "dms:message:manage", "dms:channel:manage",
        "support_chat:read", "support_chat:message:create",
    ]
)
```

Asegúrate de que la URI de redirección coincida con la que configuraste en el [panel de Whop](https://whop.com/dashboard/) > 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:

```swift theme={null}
// Sign in
try await WhopSDK.signIn()

// Sign out
WhopSDK.signOut()
```

### Seguimiento del estado de autenticación

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

```swift theme={null}
struct ChatView: View {
    @State private var isAuthenticated = false

    var body: some View {
        VStack {
            if isAuthenticated {
                Text("Signed In")
            } else {
                Text("Not Signed In")
            }
        }
        .whopAuthState($isAuthenticated)
    }
}
```

### 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.

```swift theme={null}
let tokens = await myBackend.getWhopTokens(for: currentUser)

try await WhopSDK.preSignIn(
    accessToken: tokens.accessToken,
    refreshToken: tokens.refreshToken
)
```

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

> [card] [Autenticación](https://docs.whop.com/es/developer/guides/chat/authentication.md)
>
> Compara OAuth con los tokens con alcance de cuenta para el chat incrustado.

> [card] [Guía general de OAuth](https://docs.whop.com/es/developer/guides/oauth.md)
>
> Implementa el flujo completo de OAuth y el intercambio, la renovación y la revocación de tokens.

> [card] [Chat element](https://docs.whop.com/es/developer/guides/chat/chat-element.md)
>
> Conoce las props, los eventos, los estilos y las opciones de enlaces directos de la interfaz de chat.

> [card] [Inicio rápido del chat incrustado](https://docs.whop.com/es/developer/guides/chat/quickstart.md)
>
> Muestra tu primera experiencia de chat incrustado.


## Related topics

- [Autenticación del chat](https://docs.whop.com/es/developer/guides/chat/authentication.md)
- [Inicio rápido del chat](https://docs.whop.com/es/developer/guides/chat/quickstart.md)
- [OAuth](https://docs.whop.com/es/developer/guides/oauth.md)
